home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / business / gohom10a.zip / TUTORIAL.TXT < prev    next >
Text File  |  1994-05-14  |  130KB  |  3,135 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                   G o H o m e
  13.  
  14.                                      V1.00
  15.  
  16.                     Q u i c k   S t a r t   T u t o r i a l
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                  Copyright 1993 Added Dimension Software, Inc.
  29.  
  30.  
  31.  
  32.                          Added Dimension Software, Inc.
  33.                                  6780 Abrams Rd
  34.                                  Suite 103-190
  35.                                Dallas, TX  75231
  36.  
  37.  
  38.  
  39.                              Phone: (214) 341-5759
  40.                            CompuServe ID: 73311,1062
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                                            _______                    
  48.                                       ____|__     |               (R)
  49.                                    --|       |    |-------------------
  50.                                      |   ____|__  |  Association of
  51.                                      |  |       |_|  Shareware
  52.                                      |__|   o   |    Professionals
  53.                                    -----|   |   |---------------------
  54.                                         |___|___|    MEMBER
  55.  
  56.       You should carefully read the following terms and conditions before
  57.       using this software.  Use of this software indicates your
  58.       acceptance of these terms and conditions.  If you do not agree with
  59.       them, do not use the software.
  60.  
  61.  
  62.  
  63.       Disclaimer of Warranty
  64.  
  65.       THIS SOFTWARE AND THE ACCOMPANYING FILES IS SUPPLIED "AS IS".
  66.       ADDED DIMENSION SOFTWARE, INC.  DISCLAIMS ALL WARRANTIES, EXPRESSED
  67.       OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE WARRANTIES OF
  68.       MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE.  ADDED DIMENSION
  69.       SOFTWARE, INC.  ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR
  70.       CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF GOHOME.
  71.  
  72.       BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
  73.       WHICH GOHOME MAY BE USED, NO WARRANTY OF FITNESS FOR A PARTICULAR
  74.       PURPOSE IS OFFERED.  GOOD DATA PROCESSING PROCEDURE DICTATES THAT
  75.       ANY PROGRAM BE THOROUGHLY TESTED WITH NON- CRITICAL DATA BEFORE
  76.       RELYING ON IT.  THE USER MUST ASSUME THE ENTIRE RISK OF USING THE
  77.       PROGRAM.  ANY LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY
  78.       TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.
  79.  
  80.  
  81.  
  82.       Agreement - Shareware Version
  83.  
  84.       GoHome is a "shareware program" and is provided at no charge to the
  85.       user for evaluation.  Feel free to share it with your friends, but
  86.       please do not give it away altered or as part of another system.
  87.       The essence of "user-supported" software is to provide personal
  88.       computer users with quality software without high prices, and yet
  89.       to provide incentive for programmers to continue to develop new
  90.       products.
  91.  
  92.       If you find GoHome to be a useful program and continue to use it
  93.       after a reasonable trial period (30 days), you must make a
  94.       registration payment of $50.00 to Added Dimension Software (See
  95.       "Registering GoHome" below).  The $50.00 registration fee will
  96.       license one copy for use on any one computer at any one time.  You
  97.       must treat this software just like a book.  An example is that this
  98.       software may be used by any number of people and may be freely
  99.       moved from one computer location to another, so long as there is no
  100.       possibility of it being used at one location while it's being used
  101.       at another, just as a book cannot be read by two different persons
  102.       at the same time.
  103.  
  104.       Commercial users of GoHome must register and pay for their copies
  105.       of GoHome within 30 days of first use or their license is
  106.       withdrawn.  Site-License arrangements may be made by contacting
  107.       Added Dimension Software.
  108.  
  109.       Anyone distributing GoHome for any kind of remuneration must first
  110.       contact Added Dimension Software at the address below for
  111.  
  112.  
  113.                                        2
  114.  
  115.       authorization.  This authorization will be automatically granted to
  116.       distributors recognized by the Association of Shareware
  117.       Professionals as adhering to its guidelines for shareware
  118.       distributors, and such distributors may begin offering GoHome
  119.       immediately.  However, Added Dimension Software must still be
  120.       advised so that the distributor can be kept up-to-date with the
  121.       latest version of the GoHome.  For more information see VENDOR.DOC,
  122.       included on the distribution disk.
  123.  
  124.       You are encouraged to pass a copy of GoHome along to your friends
  125.       and associates for evaluation.  Please encourage them to register
  126.       their copy if they find that they can use it.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.                                        3
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                                Table of Contents
  179.  
  180.  
  181.  
  182.       1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  1
  183.         1.1 What is GoHome? . . . . . . . . . . . . . . . . . . . . . .  1
  184.         1.2 About this Manual . . . . . . . . . . . . . . . . . . . . .  3
  185.         1.3 Manual Conventions  . . . . . . . . . . . . . . . . . . . .  3
  186.  
  187.       2. Getting Setup  . . . . . . . . . . . . . . . . . . . . . . . .  5
  188.         2.1 README.GO file  . . . . . . . . . . . . . . . . . . . . . .  5
  189.         2.2 Packing List - the files you should have  . . . . . . . . .  5
  190.         2.3 System Requirements . . . . . . . . . . . . . . . . . . . .  6
  191.         2.4 Installing GoHome . . . . . . . . . . . . . . . . . . . . .  6
  192.         2.5 Getting Help  . . . . . . . . . . . . . . . . . . . . . . .  7
  193.  
  194.       3. Using GoHome . . . . . . . . . . . . . . . . . . . . . . . . .  9
  195.         3.1 Starting GoHome . . . . . . . . . . . . . . . . . . . . . .  9
  196.         3.2 Popping Up  . . . . . . . . . . . . . . . . . . . . . . . .  9
  197.         3.3 GoHome's Main Menu  . . . . . . . . . . . . . . . . . . . . 10
  198.           3.3.1 Using GoSchedule  . . . . . . . . . . . . . . . . . . . 10
  199.           3.3.2 Using Record Script . . . . . . . . . . . . . . . . . . 12
  200.           3.3.3 Using Playback Script . . . . . . . . . . . . . . . . . 13
  201.           3.3.4 Script Commands Available When Recording  . . . . . . . 14
  202.           3.3.5 Using Run a Task  . . . . . . . . . . . . . . . . . . . 17
  203.           3.3.6 Using DOS Shell . . . . . . . . . . . . . . . . . . . . 18
  204.           3.3.7 Using Blank Screen  . . . . . . . . . . . . . . . . . . 18
  205.           3.3.8 Using Suspend Tasks . . . . . . . . . . . . . . . . . . 19
  206.  
  207.       4. Using the Program Scheduler - GoSched  . . . . . . . . . . . . 20
  208.         4.1 Starting GoSched  . . . . . . . . . . . . . . . . . . . . . 20
  209.         4.2 Editing Scripts and Batch Files . . . . . . . . . . . . . . 20
  210.         4.3 Moving Tasks Around . . . . . . . . . . . . . . . . . . . . 21
  211.         4.4 Getting Help  . . . . . . . . . . . . . . . . . . . . . . . 21
  212.  
  213.       5. Using the Script Editor - GoScript . . . . . . . . . . . . . . 22
  214.         5.1 Starting GoScript . . . . . . . . . . . . . . . . . . . . . 22
  215.         5.2 Example 1 - Typing the Date and Time  . . . . . . . . . . . 23
  216.         5.3 Example 2 - Writing the Date and Time to a File . . . . . . 27
  217.           5.3.1 Script Variables  . . . . . . . . . . . . . . . . . . . 27
  218.         5.4 Example 2 - Continued . . . . . . . . . . . . . . . . . . . 29
  219.         5.5 Example 3 - Viewing the Log File  . . . . . . . . . . . . . 31
  220.         5.6 Example 4 - Taking a Screen Snapshot  . . . . . . . . . . . 34
  221.         5.7 Example 5 - Writing a "Macro" Menu  . . . . . . . . . . . . 37
  222.  
  223.       6. Using the File Editor - GoEd . . . . . . . . . . . . . . . . . 41
  224.         6.1 Starting GoEd . . . . . . . . . . . . . . . . . . . . . . . 41
  225.         6.2 Getting Help  . . . . . . . . . . . . . . . . . . . . . . . 43
  226.         6.3 Changing Colors . . . . . . . . . . . . . . . . . . . . . . 44
  227.  
  228.       7. Appendix A - Business Stuff  . . . . . . . . . . . . . . . . . 45
  229.  
  230.  
  231.                                        i
  232.  
  233.       Contents                                                          ii
  234.  
  235.  
  236.         7.1 The Shareware Concept . . . . . . . . . . . . . . . . . . . 45
  237.         7.2 Benefits of Registering . . . . . . . . . . . . . . . . . . 46
  238.         7.3 Registering GoHome  . . . . . . . . . . . . . . . . . . . . 46
  239.         7.4 ASP Ombudsman statement . . . . . . . . . . . . . . . . . . 47
  240.  
  241.       8. Appendix B - Using Configuration Files . . . . . . . . . . . . 48
  242.  
  243.       9. Appendix C - Using /CSET and /PAL  . . . . . . . . . . . . . . 49
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.                                    Chapter 1
  251.  
  252.                                   Introduction
  253.  
  254.  
  255.  
  256.  
  257.  
  258.       1.1 What is GoHome?
  259.  
  260.       Welcome to GoHome, a suite of integrated tools that work to make
  261.       you and your computer more productive.  With GoHome, you will be
  262.       able to do a number of things such as: run programs at any time
  263.       without user intervention, create and run scripts using the built
  264.       in script interpreter, edit scripts with the unique script editor,
  265.       use the unique notepad editor that can "pop-up" over other
  266.       programs, access the DOS prompt even while in the middle of another
  267.       program, use the built in screen blanker, and more.
  268.  
  269.       With GoHome, you will also be able to run ANY program at the press
  270.       of a couple of keys - even if you are in the middle of running
  271.       another program!  This feature alone, makes GoHome indispensable.
  272.       For instance, say you're in the middle of editing a document and
  273.       the phone rings.  It's Bill from accounting and he wants to know
  274.       the current sales figures for this month.  You pop-up GoHome and
  275.       have it run your spreadsheet and load the month's figures for you
  276.       (GoHome will swap out your editor to free up enough memory for the
  277.       spreadsheet program and then start up the program and load the
  278.       proper spreadsheet data).  You can then provide Bill with the data
  279.       he needs and exit the spreadsheet (GoHome will restore your editor
  280.       to the state it was in just prior to running the spreadsheet).
  281.       Oops, you forgot to tell Bill that the numbers you gave him didn't
  282.       include your last big sale.  You pop-up GoHome once again and have
  283.       it run GoEd (GoHome's notepad editor) and load the company's phone
  284.       list for you.  You then search for Bill's name to get his phone
  285.       number.  When you get done talking to Bill, you can get back to
  286.       work right where you were before he called.
  287.  
  288.       Hopefully, you're starting to get an idea of some of the things
  289.       that GoHome can do for you.  The next couple of paragraphs discuss
  290.       some of these features in a little more detail.  Following that is
  291.       a hands-on tutorial designed to get you using GoHome and
  292.       incorporated into your daily routine as quick as possible.
  293.  
  294.       GoHome's flexible scheduler allows you to schedule a program to run
  295.       at any time of the day - on any week day, or any day of the month,
  296.       or just on a specific day of the year.  You can also schedule a
  297.       program to be repeated throughout a portion of the day at minute
  298.       intervals.  For example, you might set up a schedule similar to the
  299.       following:
  300.  
  301.  
  302.                                        1
  303.  
  304.            Start    End   Repeat    When     Description
  305.            ---------------------------------------------------------
  306.            1:00a     -      -       M W F S  Partial Tape Backup
  307.            1:00a     -      -      S         Full Tape Backup
  308.            10:00a  3:00p  10 mins   MTWRF    Run network monitor
  309.            3:00a     -      -      1 15      Print out employees
  310.                                              checks
  311.            9:00a     -      -      12/01/94  ALARM - Get Christmas
  312.                                              presents
  313.            11:00p    -      -        T R     Update database tables
  314.            10:00p    -      -      8/30/94   Print annual report.
  315.            9:00a   4:00p  60 mins    MTWRF   Get latest stock quotes
  316.                                              from BBS
  317.  
  318.       GoHome can be taught to run programs that would normally require
  319.       user intervention by using its powerful scripting language.  A
  320.       "script" is created that lists the steps necessary to run the
  321.       program.  For most scripts, you just run the program as you would
  322.       normally, GoHome will remember the keystrokes as you type them.  If
  323.       a program takes a varying amount of time to perform a task (i.e.
  324.       downloading a file from a BBS), GoHome can be instructed to wait
  325.       until a particular pattern of text appears on the screen (i.e.
  326.       "Download successful") before continuing.
  327.  
  328.       For more complicated tasks, GoHome includes a script editor that
  329.       makes writing scripts a breeze.  Using the script editor, you can
  330.       have a script do a large number of things such as: type the current
  331.       date and time, take a snapshot of a portion of the screen, display
  332.       a menu, perform an if-goto test and branch, run a previously
  333.       scheduled task, beep, prompt for input, blank the screen, reboot,
  334.       display a message box, write to a file, print to a printer, and
  335.       more.
  336.  
  337.       You can even use GoHome's powerful features when you are using the
  338.       computer.  Scripts are not limited to running programs unattended.
  339.       They can also be used as a sort of "super" keyboard macro
  340.       player/recorder to simplify starting programs, or any task within
  341.       the program.
  342.  
  343.       GoHome also has a "Give me a DOS prompt!" function.  For instance,
  344.       if you're in the middle of a program and want to run another
  345.       program but you don't want to leave the program you're in (for
  346.       example, you want to see a directory listing), GoHome can be
  347.       popped-up and will swap-out the current program and run the program
  348.       you want.  When you're done with that program, just exit it and
  349.       GoHome will bring you right back to the program you where in!
  350.  
  351.       You can also set Reminder messages with GoHome that will alert you
  352.       at the specified time of important events, like meetings and
  353.       birthdays.
  354.  
  355.       GoHome even has a built-in screen blanker to help keep your monitor
  356.       safe from "burn-in" and to keep the people who walk into your
  357.       office from seeing what you're working on.
  358.  
  359.  
  360.  
  361.                                        2
  362.  
  363.       GoHome also comes with a small but powerful editor called GoEd.  By
  364.       using GoEd with GoHome, you can have a pop-up at any time notepad
  365.       editor that's handy for jotting down notes while in other programs,
  366.       modifying batch files, creating memos, etc.  It also can display
  367.       text in different colors.
  368.  
  369.  
  370.       1.2 About this Manual
  371.  
  372.       If you're like most people, the last thing you want to do is to
  373.       read a manual.  However, many of the nuances and uses for GoHome
  374.       are not immediately obvious by just "plowing" straight into the
  375.       programs.  It is, therefore, STRONGLY suggested that you print this
  376.       manual out (if you haven't already) and take a few minutes to work
  377.       through the examples.
  378.  
  379.       The intent of this manual is to get you up and going in the
  380.       shortest amount of time.  When you're done, you should have a good
  381.       understanding of what GoHome can do and how it can be used to
  382.       perform everyday, mundane tasks, automatically.  This manual
  383.       doesn't attempt to explain everything little thing that GoHome can
  384.       do; for that, refer to the on-line help (see "Getting Help"
  385.       described later) This manual is written in a tutorial type form.
  386.       You'll get the most benefit from it if you perform the steps
  387.       indicated in each example.
  388.  
  389.       To make this manual as short as possible, it is assumed that you
  390.       have a basic understanding of how DOS works and that you can create
  391.       directories, and execute programs from the DOS prompt.
  392.  
  393.  
  394.       1.3 Manual Conventions
  395.  
  396.       To make this tutorial as easy to understand as possible, the
  397.       following conventions are used throughout:
  398.  
  399.            Example       Meaning
  400.            --------------------------------------------------------------
  401.            <F1>          Angle brackets are used to indicate a specific
  402.                          key or key combination. In this example, the F1
  403.                          key should be pressed.
  404.  
  405.            <Alt><F>      For this key combination, you would press and
  406.                          hold the ALT key, then press and release the "F"
  407.                          key, then release the ALT key.
  408.  
  409.            "dir"         When instructed to enter a sequence of keys, a
  410.                          pair of quotation marks may be used to set off
  411.                          the keys. Do not type in the quotation marks.
  412.  
  413.            "File|Open"   This is used to indicate a menu selection. In
  414.                          this case you would select the top-level menu
  415.                          "File", a drop-down menu would appear containing
  416.                          a menu item named "Open". You would then move the
  417.                          highlight bar to "Open" and hit the enter key.
  418.  
  419.  
  420.                                        3
  421.  
  422.  
  423.            C:>           The "C:>" characters are used to represent the
  424.                          DOS prompt, in most cases, your prompt will be
  425.                          different.
  426.  
  427.       At times, "GoHome" is used to represent the ENTIRE suite of
  428.       programs that make up this release.  At other times, "GoHome" is
  429.       used to refer to just the PROGRAM named GoHome - the meaning should
  430.       be clear based on the context that it's in.  You will also see the
  431.       following used throughout this manual: GoHome, GoSched, GoScript,
  432.       GoEd, and GoHelp; these refer to the programs GOHOME.EXE,
  433.       GOSCHED.EXE, GOSCRIPT.EXE, GOED.EXE, and GOHELP.EXE, respectively.
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                                        4
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.                                    Chapter 2
  487.  
  488.                                  Getting Setup
  489.  
  490.  
  491.  
  492.  
  493.  
  494.       2.1 README.GO file
  495.  
  496.       Before installing GoHome, it's IMPORTANT to read the file README.GO
  497.       for any last minute information that concerns installing and using
  498.       GoHome.
  499.  
  500.  
  501.       2.2 Packing List - the files you should have
  502.  
  503.       The complete GoHome evaluation package contains the following
  504.       files.  If any of these files are missing, the package is not
  505.       complete and is not suitable for distribution to others.  The
  506.       complete package may be obtained directly from Added Dimension
  507.       Software.
  508.  
  509.            File Name       Purpose of File
  510.            ---------------------------------------------------------------
  511.            README.GO       Important last-minute information
  512.            README.BAT      View README.GO using GoEd
  513.            VENDOR.DOC      Information and restrictions for disk vendors,
  514.                            distributors, user groups, and more.
  515.            REGFORM.TXT     Registration information and order form.
  516.            TUTORIAL.TXT    This document
  517.  
  518.            GOHOME.EXE      GoHome main program
  519.            GOSCHED.EXE     Task scheduler and editor
  520.            GOSCRIPT.EXE    Script editor
  521.            GOED.EXE        File editor
  522.            GOHELP.EXE      Help facility
  523.  
  524.            GOHOME.HLP      on-line help file for GoHome
  525.            GOSCHED.HLP     on-line help file for GoSched
  526.            GOSCRIPT.HLP    on-line help file for GoScript
  527.            GOED.HLP        on-line help file for GoEd
  528.  
  529.            GODEMO.BAT      Runs a simple demo of GoHome
  530.            *DEMO.SCR       Script files used in GODEMO
  531.  
  532.            TASKS.DAT       Sample GoHome task data file.
  533.            ASCII.TXT       Sample text file showing some features
  534.                            of GoEd.
  535.            EXAMPLE?.SCR    Example script files from
  536.  
  537.  
  538.                                        5
  539.  
  540.                            "Using the Script Editor - GoScript" Chapter.
  541.                            NOTE: These files are in a self-extracting file
  542.                            named, "EXAMPLES.EXE". Type "EXAMPLES" at the
  543.                            DOS prompt to extract them.
  544.  
  545.  
  546.       2.3 System Requirements
  547.  
  548.       GoHome and its utilities require the following:
  549.  
  550.            An IBM PC or 100% compatible
  551.            DOS 3.3 or later
  552.  
  553.       Recommended but not required:
  554.  
  555.            Extended or Expanded memory (for faster program swapping)
  556.            Hard Disk Drive
  557.  
  558.  
  559.       2.4 Installing GoHome
  560.  
  561.       Installing GoHome is both simple and straightforward.  This section
  562.       explains the necessary steps.
  563.  
  564.       1.  Create a directory on your hard disk that will contain GoHome.
  565.           For example, to create a directory called GOHOME on your C
  566.           drive, enter the following at the DOS prompt:
  567.  
  568.                C:> MD C:\GOHOME
  569.  
  570.           (Do not type in "C:>" above, it is used to indicate that the
  571.           command is to be typed at the DOS prompt.)
  572.  
  573.       2.  Copy all of the files from the distribution disk into the
  574.           directory you created in step 1.  For example, if the
  575.           distribution disk is in drive A you would type the following:
  576.  
  577.                C:> COPY A:*.* C:\GOHOME
  578.  
  579.           If you received GoHome in a compressed format, decompress it
  580.           now using the appropriate decompress program (most likely you
  581.           will need PKUNZIP.EXE).  You may delete the compressed file
  582.           once it has been decompressed.  Make sure to keep a backup
  583.           before you do.
  584.  
  585.           NOTE: It's important to keep *all* the files in one directory.
  586.           GoHome assumes that the utility programs and help files are all
  587.           in the same directory.
  588.  
  589.       3.  Make sure that the COMSPEC environment variable is set to the
  590.           path for DOS's COMMAND.COM.  This is extremely IMPORTANT and
  591.           GoHome will NOT run properly if COMSPEC is not set correctly.
  592.           To check this, enter
  593.  
  594.  
  595.  
  596.  
  597.                                        6
  598.  
  599.                C:> SET | MORE
  600.  
  601.           Look for the word COMSPEC and note the value assigned to it
  602.           (you may have to hit <Enter> if the above command displays
  603.           "more" at the bottom of the screen).  You should see a line
  604.           similar to
  605.  
  606.                COMSPEC=C:\DOS\COMMAND.COM
  607.  
  608.           If you're using 4DOS you should see a line similar to
  609.           COMSPEC=c:\4dos\4dos.com; and if you're using NDOS look for
  610.           COMSPEC=c:\norton\ndos.com.
  611.  
  612.           If COMSPEC is not set or it does not contain the correct path,
  613.           edit your AUTOEXEC.BAT file to include a statement similar to
  614.           SET COMSPEC=C:\DOS\COMMAND.COM.  It is necessary for you to
  615.           reboot after modifying the COMSPEC variable for your changes to
  616.           take affect.
  617.  
  618.           That is all that is required to begin using GoHome, however,
  619.           it's suggested that you perform the following steps to have
  620.           easy access to the GoHome programs.
  621.  
  622.       4.  Edit your AUTOEXEC.BAT file to include the directory you
  623.           created in step 1 to your PATH statement.  For example, if your
  624.           current PATH statement is
  625.  
  626.                PATH=C:\DOS;C:\WORD
  627.  
  628.           you would modify the statement to include GoHome's directory
  629.           similar to
  630.  
  631.                PATH=C:\DOS;C:\WORD;C:\GOHOME
  632.  
  633.       5.  To have GoHome automatically loaded every time you boot the
  634.           computer, add the following line toward the end of your
  635.           AUTOEXEC.BAT file:
  636.  
  637.                C:\GOHOME\GOHOME.EXE
  638.  
  639.  
  640.       2.5 Getting Help
  641.  
  642.       This manual does NOT provide complete documentation for all the
  643.       features of the programs.  For additional information, refer to the
  644.       on-line help system; type in "GOHELP" at the DOS prompt (i.e.  C:>
  645.       GOHELP<Enter>).  A menu will be displayed from which you can select
  646.       the program that you want help on.  The GoHelp program can also
  647.       take a parameter that specifies which program to display help on.
  648.       For example, entering "GOHELP GOHOME" will display help for GoHome.
  649.       Enter "GOHELP /?" to see all the parameters that can be used with
  650.       GoHelp.
  651.  
  652.       When GoHelp starts, it will display a table of contents screen.
  653.       This first topic listed explains how to navigate through the help
  654.  
  655.  
  656.                                        7
  657.  
  658.       system.  Briefly, use the up and down arrow keys and the page up
  659.       and page down keys to scroll through the table of contents.  When
  660.       the highlighted line is on the item you want help for, hit <Enter>
  661.       to display the help text for that item.
  662.  
  663.       In addition to the on-line help systems, most of the programs have
  664.       context-sensitive help that can be activated at any time by hitting
  665.       the <F1> key.  GoHome (the program itself, GOHOME.EXE) does not
  666.       have any context-sensitive help since doing so would require
  667.       additional memory that is better used by other programs.
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.                                        8
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                    Chapter 3
  723.  
  724.                                   Using GoHome
  725.  
  726.  
  727.  
  728.  
  729.  
  730.       3.1 Starting GoHome
  731.  
  732.       GoHome is a memory-resident program (sometimes referred to as a
  733.       terminate-and-stay-resident (TSR) program).  This means that when
  734.       you load GoHome, it will run for a second or two and then return to
  735.       the DOS prompt.  It will appear as if it finished running but it is
  736.       really still loaded in your computer's memory, running in the
  737.       background.  You can now continue to run other programs; when you
  738.       want, you can have GoHome "pop-up" at any time.
  739.  
  740.       1.  If the directory containing GoHome is not in your PATH, change
  741.           to the directory containing GoHome (i.e.  C:> CD GOHOME).
  742.  
  743.       2.  GoHome is started by typing "GOHOME" at the DOS prompt.
  744.  
  745.       3.  GoHome will display a small sign-on banner and then go
  746.           resident.  (If you have an unregistered version of GoHome, a
  747.           window will pop-up displaying information on how to register
  748.           GoHome.  You'll have to hit the <G> key to continue.  This
  749.           window is NOT in the registered version.  This window is the
  750.           only thing that is different between the unregistered and the
  751.           registered version.)
  752.  
  753.       Note: GoHome can be removed from memory by using the /U
  754.       command-line option (i.e.  C:> GOHOME /U).
  755.  
  756.  
  757.       3.2 Popping Up
  758.  
  759.       Once GoHome has been started, you can bring up its menu at any time
  760.       by typing the hot-key.  The default hot-key is <Ctrl><SPACE> and
  761.       may be changed using the /HKEY command line parameter (see GoHome's
  762.       on-line help for more information and how to change the hot-key).
  763.  
  764.       To verify that GoHome is indeed running, invoke GoHome by pressing
  765.       its hot-key: hold down the <Ctrl> key and tap the space bar, then
  766.       immediately release both keys.  A menu should appear centered on
  767.       you screen.  This is GoHome's main menu.
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.                                        9
  775.  
  776.       3.3 GoHome's Main Menu
  777.  
  778.       GoHome's main menu consists of the following menu items:
  779.  
  780.            Menu Item        Action Performed
  781.            -----------------------------------------------------------
  782.            GoSchedule       Invoke the program scheduler (GoSched)
  783.            Record Script    Start recording a script
  784.            Playback Script  Playback a previously recorded script
  785.            Run a Task       Run and scheduled task
  786.            DOS Shell        Bring up a DOS prompt - swapping
  787.                             out the current application if necessary
  788.            Blank Screen     Blank the screen - hit any key to unblank
  789.            Suspend Tasks    Suspend any and all scheduled tasks
  790.  
  791.       Working under the belief that an example is worth a thousand words
  792.       (or is that a picture?), we'll quickly demonstrate each item in
  793.       GoHome's main menu.
  794.  
  795.  
  796.  
  797.       3.3.1 Using GoSchedule
  798.  
  799.       As stated previously, GoHome's task scheduler is called, GoSched.
  800.       GoSched is used to set the start and end times, and the day(s) on
  801.       which a task should run.  It also serves as a sort of "Command
  802.       Center" for the GoHome programs.  As we'll see a little later, the
  803.       script and file editors can be invoked quite easily in GoSched to
  804.       edit particular tasks.  GoSched can also be used during everyday
  805.       activities to act as a "Program Menu" to launch and run tasks.
  806.  
  807.       To get a better idea of what GoSched can do, let's schedule a
  808.       simple task to display all of the executable files that have a
  809.       ".exe", ".com", and ".bat" file extension.
  810.  
  811.       1.  If you haven't already, press GoHome's hot-key to display the
  812.           main menu.
  813.  
  814.       2.  Select the first item in the menu, "GoSchedule", by hitting the
  815.           enter key.
  816.  
  817.       3.  If GoHome has been installed correctly, the GoSched program
  818.           should have started and you should see a number of task edit
  819.           fields in the top-half of the screen and a list of tasks in the
  820.           bottom half.  For now, we will just enter a simple task (don't
  821.           worry if you don't understand what all the fields mean, they
  822.           will be discussed in 4 on page 20.
  823.  
  824.       4.  If necessary, press <Shift><DownArrow> to move to a task that
  825.           is not currently used.
  826.  
  827.       5.  In the "Description" field, type in: Display executable files
  828.  
  829.       6.  Hit the <TAB> key to go to the "Task Type" field.  Hit the down
  830.           arrow key to display a list of task types and then hit the down
  831.  
  832.  
  833.                                        10
  834.  
  835.           arrow key twice more to position the highlight line over
  836.           "Command Line".  Select "Command Line" as the task type by
  837.           pressing the <Enter> key.
  838.  
  839.       7.  Tab to the next field (labeled "Command") and type the
  840.           following:
  841.  
  842.                dir *.exe; dir *.com; dir *.bat
  843.  
  844.           A "Command" task can take any command that can be typed at the
  845.           DOS prompt.  Multiple commands may be specified by separating
  846.           them with a semi-colon (";").
  847.  
  848.       8.  We'll leave the rest of the fields alone.  Press the <F2> key
  849.           to save the task to the default task file named "tasks.dat".
  850.  
  851.       9.  Hit <F3> to exit GoSched.
  852.  
  853.       10. To run the task, bring GoSched up again (hit GoHome's hot-key
  854.           and then select "GoSchedule" from the menu.  At the bottom of
  855.           the screen there is a small help window that displays the
  856.           function keys and the action that is performed when one is
  857.           pressed.  From this we see that the <F4> key is used to run the
  858.           task highlighted in the task list (the same one that's
  859.           displayed in the edit fields).
  860.  
  861.           Use <Shift><DownArrow>, if necessary, to highlight the task
  862.           just entered.  Press <F4> to run the task.  You will see that
  863.           this causes GoSched to exit, and shortly after that, a window
  864.           will "pop-up" centered on your display.  This is GoHome's
  865.           Countdown window.  Note that the text you entered in the
  866.           description field is displayed in the window.  GoHome will wait
  867.           for fifteen seconds before running the task.  If you want, you
  868.           can press <C> to Cancel the task (i.e.  don't run it), press
  869.           "R" to Run it now (i.e.  don't wait for fifteen seconds), or
  870.           press "S" to Snooze which will delay running the task for five
  871.           minutes.
  872.  
  873.           If you press <R> or wait for fifteen seconds, GoHome will run
  874.           the task which, in this case, just executes three DIR commands.
  875.  
  876.           If you want, take some time and try out some different
  877.           commands.  If you want to run a batch file, be sure to set the
  878.           task type to "Batch File".  Also, see what happens when you
  879.           select "Reminder" as the task type and type in some text in the
  880.           "Note" ("Command") field.
  881.  
  882.           You might also try running a program, such as a word processor,
  883.           before bringing up GoHome's main menu.  When you run a task
  884.           this time, GoHome will "swap" the program out of memory, run
  885.           the task, and then "swap" the program back into memory
  886.           restoring everything just the way it was.  (GoHome will also
  887.           swap out programs that are in "graphics mode"; however, GoHome
  888.           will not display any menus or windows.  It will, instead, beep
  889.           twice when it is expecting you to make a menu selection or to
  890.  
  891.  
  892.                                        11
  893.  
  894.           press a key.  You are, so to speak, "flying blind".  It will
  895.           become much easier once you get more familiar with the way
  896.           GoHome works.)
  897.  
  898.  
  899.  
  900.       3.3.2 Using Record Script
  901.  
  902.       The next item in GoHome's main menu is "Record Script".  Scripts
  903.       are created to run programs that cannot be run to completion
  904.       because they are expecting a user to interact with it.  GoHome's
  905.       scripting language and tools can be used to quickly "learn"
  906.       specific tasks, yet are powerful enough to control complicated
  907.       procedures.  Scripts can also be used as a "Super Macro" program to
  908.       simplify tasks within any program.
  909.  
  910.       In the following example, we will create a simple script to start
  911.       up an editor (we'll use GoEd, but any editor could be used) and
  912.       type in our address.  You should also be in the directory that
  913.       contains the GoHome programs.
  914.  
  915.       1.  From the DOS prompt, bring up GoHome's main menu (enter the
  916.           hot-key <Ctrl>space) and select the second menu item, "Record
  917.           Script".
  918.  
  919.       2.  GoHome will prompt you to enter the name of the file that you
  920.           want the script to be saved to.  In this case, type in:
  921.           "LETTER" (without the quotes of course).  After entering the
  922.           file name, hit <Enter> to continue.
  923.  
  924.           If an extension is not given, GoHome will use ".scr".  If a
  925.           path for the file is not specified, GoHome will use the
  926.           directory that contains the GoHome programs; this will save you
  927.           from having to type in the path every time a script is run.
  928.  
  929.       3.  Once the file name is entered, GoHome will replace the main
  930.           menu with a menu that displays a number of script commands.
  931.           The script commands listed in the menu are a subset of those
  932.           available and are generally the ones used the most.
  933.  
  934.           Also notice that the characters "Rec:" are displayed in the
  935.           top-right corner of the screen.  As a default, GoHome will
  936.           display the current script item that is selected.  This is
  937.           useful to remind you that you are recording a script.  You can
  938.           turn off the status display by using the command line option,
  939.           "/DBG=N", when GoHome is first started.
  940.  
  941.           IMPORTANT: When recording keys, GoHome keeps track of the time
  942.           interval between keys.  For this reason, please read steps 4
  943.           through 6 below, before entering the keys; otherwise, there
  944.           might be long delays between keystrokes.
  945.  
  946.           To start GoHome recording keystrokes, select the first menu
  947.           item, "Keys" (the status display will change to indicate that
  948.           you are recording keys).
  949.  
  950.  
  951.                                        12
  952.  
  953.       4.  Type in the following at the DOS prompt:
  954.  
  955.                C:> goed letter.doc <Enter>
  956.  
  957.           This will start up GoEd (the file editor).  Note that when
  958.           you're recording keys, GoHome will beep each time you press a
  959.           key.
  960.  
  961.       5.  Now, enter your name and address.  (Note that GoEd functions
  962.           like most other editors).  Begin by hitting the <TAB> key eight
  963.           times to position the cursor in the middle of the screen.  Type
  964.           your name, then below it enter your address, city, state, and
  965.           zip code.  Then hit enter a couple of times to move down a
  966.           couple of lines, and type "Dear Sir,".
  967.  
  968.       6.  Save the script by bringing up the Recorder menu (use the
  969.           hot-key; since we're recording, GoHome will display the
  970.           Recorder menu instead of the main menu) and selecting the last
  971.           item on the menu, "Save Script".
  972.  
  973.       7.  Exit GoEd by pressing <F3>, when asked to save to a file, Tab
  974.           to the "No" button and press <Enter>.
  975.  
  976.       You now have a script that will start up GoEd and type in your
  977.       address and a greeting without you doing anything!
  978.  
  979.       NOTE: If a path is not given on the script to record (or to play),
  980.       GoHome will create the script file in the same directory that
  981.       GoHome is in (i.e.  the script will be in C:\GOHOME).
  982.  
  983.       The next section will explain how to play back scripts.
  984.  
  985.  
  986.  
  987.       3.3.3 Using Playback Script
  988.  
  989.       The third menu item in GoHome's main menu is "Playback Script" and
  990.       is used (amazingly enough) to play back script files.  You will be
  991.       prompted for the name of the script file to play, and then the
  992.       script will be played.
  993.  
  994.       To playback the letter script recorded in the last section:
  995.  
  996.       1.  Bring up GoHome's main menu
  997.  
  998.       2.  Select the third menu item, "Playback Script"
  999.  
  1000.       3.  the name of the script file to playback.  In this case, enter
  1001.           "letter".
  1002.  
  1003.       That's it.  Sit back and watch while GoHome enters the keys you
  1004.       typed previously, just as you typed them, even including the pauses
  1005.       between keys!  If you made a few typing errors or paused too long
  1006.       between keystrokes, don't worry, we'll see later how GoScript can
  1007.       be used to edit them.
  1008.  
  1009.  
  1010.                                        13
  1011.  
  1012.       It is possible to pause and abort a script while it is being played
  1013.       back.  To do so, use the hot-key to bring up GoHome's menu.  Since
  1014.       we're playing a script, GoHome displays the playback menu that
  1015.       consists of just two items: Pause and Abort.  If you select pause,
  1016.       the script will pause and wait for you to resume playing.  You
  1017.       resume playing by, once again, using the hot-key to bring up the
  1018.       playback menu and select the Resume menu item.
  1019.  
  1020.       If the way GoHome "changes" menus reads confusing, rest assured
  1021.       that it will seem straight forward when it's used.  The only thing
  1022.       you have to do is remember the hot-key.  GoHome will display the
  1023.       menu that is appropriate for the given context.
  1024.  
  1025.  
  1026.  
  1027.       3.3.4 Script Commands Available When Recording
  1028.  
  1029.       Let's pause here and quickly review the other script commands that
  1030.       can be used when recording a script "interactively".  (Note that
  1031.       the commands shown here are just a subset of the total commands
  1032.       allowed by the script language).
  1033.  
  1034.       The following table lists these script commands and a brief
  1035.       description of what they are used for.
  1036.  
  1037.            Script Command       Description
  1038.            ----------------------------------------------------------
  1039.            Keys                 Record all keystrokes and the time
  1040.                                 interval between them.
  1041.            WaitKeyBuff          Wait until all the keys in the
  1042.                                 keyboard buffer have been read in by
  1043.                                 the program currently running. (Note:
  1044.                                 the program currently running may be
  1045.                                 the DOS command prompt).
  1046.            Delay                Pause play back of the script for a
  1047.                                 specified number of seconds.
  1048.            WaitAtPos            Wait until the specified text appears
  1049.                                 in a defined section of the display. A
  1050.                                 time out value may be added using the
  1051.                                 script editor, GoScript.
  1052.            WaitRelCrs           Wait until the specified text appears
  1053.                                 relative to the current cursor
  1054.                                 position.  A time out value may be
  1055.                                 added using the script editor.
  1056.            Comment              Enter a comment. A comment is used to
  1057.                                 describe what the script is doing.
  1058.                                 This description can be anything that
  1059.                                 you feel is important to remember - it
  1060.                                 is not used by GoHome. It may also be
  1061.                                 useful to make notes of script
  1062.                                 commands that you want to add later in
  1063.                                 GoScript.
  1064.            Beeper               Makes a beeping noise. The type of beep
  1065.                                 that is made can be changed by
  1066.                                 modifying it in GoScript.
  1067.  
  1068.  
  1069.                                        14
  1070.  
  1071.            Save Macro           Stop recording the script and save it
  1072.                                 to file.
  1073.  
  1074.       The "WaitAtPos" and "WaitRelCrs" are two very useful commands.
  1075.       Let's explore them in a little more detail.
  1076.  
  1077.       When you first start to automate some of your more repetitive
  1078.       programs, you'll discover that just recording keystrokes is not
  1079.       sufficient.  A lot of programs take a varying amount of time to
  1080.       execute (i.e.  tape backup programs) or they must wait for an event
  1081.       to occur before continuing (i.e.  a communications program will
  1082.       need to wait until a connection is made and a logon prompt is
  1083.       displayed).  The "WaitAtPos" command will stop processing script
  1084.       commands until a specified pattern of text appears in a pre-
  1085.       determined area of the screen (which may be the entire screen).
  1086.       The "WaitRelCrs" command is very similar to the "WaitAtPos" command
  1087.       except that the pattern of text must appear in a pre-determined
  1088.       area relative to the current position of the cursor.
  1089.  
  1090.       To demonstrate how these commands work, we'll use a very contrived
  1091.       example.  Try to imagine how these commands could be used to write
  1092.       a communications script that would start a communication program,
  1093.       have it dial and connect to a BBS, wait for the logon prompt, enter
  1094.       your name, wait for the password prompt, enter your password, etc.
  1095.  
  1096.       In this example, we will write a useless (but hopefully,
  1097.       instructional) script that will clear the screen, wait for you to
  1098.       enter the characters "dir" in the top-left portion of the screen,
  1099.       type <Enter> to execute the "dir" command, and then beep twice.
  1100.  
  1101.       1.  From the DOS prompt, bring up the main menu and select "Record
  1102.           Script".
  1103.  
  1104.       2.  Enter "useless" for the name of the file to store the script in
  1105.           (Note: GoHome will append ".scr" for the file's extension).
  1106.  
  1107.       3.  Select "Keys".
  1108.  
  1109.       4.  Type in "cls" and then <Enter> to clear the screen.
  1110.  
  1111.       5.  Use the hot-key to display the Recorder menu and select
  1112.           "WaitAtPos".  You will now be prompted to define the portion of
  1113.           the screen that will be searched.  The cursor will change to a
  1114.           "tall" cursor and a short help line is displayed at the top of
  1115.           the screen.  Use the arrow keys to move the cursor around.
  1116.           <Home> will move the cursor to the first column, <End> will
  1117.           move it to the last column.  <PageUp> and <PageDown> move the
  1118.           cursor to the first and last row, respectively.  If you hold
  1119.           down the <Ctrl> when using the left and right arrow keys, the
  1120.           cursor will move eight characters at a time.
  1121.  
  1122.           For this example, move the cursor near the top-left corner of
  1123.           the screen (the exact location doesn't matter).  To "mark" the
  1124.           corner, hit <Enter>.  Now, move the cursor to the middle of the
  1125.           screen and hit <Enter> again to complete the definition of the
  1126.  
  1127.  
  1128.                                        15
  1129.  
  1130.           search area.  If after hitting <Enter> to mark the first
  1131.           corner, you change your mind and want to reposition the corner,
  1132.           hit <ESC>, then move to the new position and hit <Enter> again.
  1133.  
  1134.           Once the search area is defined, GoHome will prompt you to
  1135.           enter the text that it should wait on to appear in the search
  1136.           area.  For our example, type in "dir".
  1137.  
  1138.       6.  Bring up the Recorder menu again and select, "Keys".  Hit the
  1139.           <Enter> key.
  1140.  
  1141.           NOTE: You should use "WaitAtPos" when the text will appear in a
  1142.           fixed location.  Use "WaitRelCrs" when the text doesn't always
  1143.           appear in the same location but it can be determined by the
  1144.           position of the cursor.  An example of this would be the logon
  1145.           prompt in most BBSs (the cursor is on the same line or the line
  1146.           below the logon prompt).
  1147.  
  1148.       7.  Bring up the Recorder menu and select "Beeper".
  1149.  
  1150.       8.  Bring the Recorder menu up again and select "Delay".  When
  1151.           prompted for the number of seconds to delay enter 1.
  1152.  
  1153.       9.  Bring up the Recorder menu and select "Beeper".
  1154.  
  1155.       10. Bring up the Recorder menu and select "Save Script".
  1156.  
  1157.       Now let's play back the script we've just recorded.  As the script
  1158.       is played back, keep an eye on the script status window in the
  1159.       top-right corner of the screen.
  1160.  
  1161.       1.  From GoHome's main menu, select "Playback Script".  When
  1162.           prompted, type in "useless" for the file name.
  1163.  
  1164.       2.  You should see GoHome type in the "cls" DOS command and the
  1165.           screen should clear.
  1166.  
  1167.       3.  A larger green block should appear on the screen where you
  1168.           defined the search area for "dir".  GoHome is now waiting for
  1169.           the three characters in "dir" to appear in the green block.
  1170.           You may have to hit <Enter> and a few spaces a couple of times
  1171.           to get the cursor inside the block.  Once it's inside, type in
  1172.           "dir".  Note that the search for "dir" is CASE-SENSITIVE (you
  1173.           may want to try entering DIR to verify this).  Once GoHome
  1174.           detects that "dir" is inside the block, it will continue.
  1175.  
  1176.       4.  Recall what you did in step 6 above.  GoHome will now type in
  1177.           an <Enter> key that will cause DOS to display a directory
  1178.           listing.
  1179.  
  1180.       5.  The last couple of things the script does is to beep, pause a
  1181.           second, and then beep again.  Hopefully you're beginning to get
  1182.           an idea of how to create your own scripts.  There are more
  1183.           examples in the "5 section.
  1184.  
  1185.  
  1186.  
  1187.                                        16
  1188.  
  1189.       3.3.5 Using Run a Task
  1190.  
  1191.       The fourth item in GoHome's main menu is "Run a Task".  This item
  1192.       is used to run a task that has been entered into GoSched.  When
  1193.       selected, a dialog box prompting for the task number to run is
  1194.       displayed.  The number you enter corresponds to the number of the
  1195.       task in GoSched's Task List.  Once a number has been entered and
  1196.       the <Enter> key pressed, GoHome will run the task.  If the task
  1197.       doesn't have the "No countdown window" checked (bring up GoSched's
  1198.       "Options" dialog box for the task), the countdown window will be
  1199.       displayed.
  1200.  
  1201.       If you added the "Display executable files" task defined in a
  1202.       previous section, then you can run it by selecting the "Run a Task"
  1203.       menu item in GoHome's main menu.  When prompted for the task to
  1204.       run, enter its number in GoSched's task list (probably 2) and then
  1205.       press the <Enter> key.  GoHome will display the countdown dialog,
  1206.       hit <Enter> to run the task without having to wait for the timer to
  1207.       countdown to zero.
  1208.  
  1209.       Note that it is not necessary to be at the DOS prompt when you run
  1210.       a task.  Try this: run another program (i.e.  GoEd, or your
  1211.       editor), bring up GoHome's main menu and press the <R> key to
  1212.       select "Run a Task".  Enter the task number and <Enter>.  Press
  1213.       <Enter> again when the countdown window appears.  GoHome will
  1214.       temporarily swap out your program to make "room" for the task to
  1215.       run.  Once the task completes, GoHome will restore everything just
  1216.       the way it was before the task ran.  In this example, you may not
  1217.       be able to see the results of the directory listings because GoHome
  1218.       will restore your program as soon as the last directory command
  1219.       finishes.  GoHome has a task option that will pause and wait for
  1220.       you to hit a key whenever it finishes running the task.
  1221.  
  1222.       To have GoHome pause when a task finishes, select the "Pause when
  1223.       done" option in GoSched's "Option" dialog.  Briefly, bring up
  1224.       GoHome's main menu, press <S> to run GoSched, select the task to be
  1225.       modified by using the arrow keys to highlight the task in the "Task
  1226.       List", press <Alt><O> to pop- up the "Options" dialog, press
  1227.       <Alt><P> to move to the "Pause when done" option, press the space
  1228.       bar to mark or select the option, press <Enter> to return from the
  1229.       "Options" dialog, then press <F3> to exit GoSched, and answer "Yes"
  1230.       when asked to save the changes.  That previous sequence reads long
  1231.       but once you get familiar with both GoHome and GoSched it will
  1232.       become straight forward.
  1233.  
  1234.       NOTE: The "Pause when done" option is only used when GoHome must
  1235.       swap out a program in order to run another one.  In otherwords, if
  1236.       you're at the DOS prompt and run the task, GoHome will not pause
  1237.       when the task completes.
  1238.  
  1239.       Run the task again and note that GoHome will now pause when the
  1240.       task finishes.  This gives you time to see the results of the task.
  1241.       GoHome will wait up to one minute for a key to be pressed.  If a
  1242.       key has not been pressed after one minute, GoHome will "press" a
  1243.       key for you and return back to the program that was interrupted.
  1244.  
  1245.  
  1246.                                        17
  1247.  
  1248.       TIP: In addition to entering task numbers in the "Run a Task"
  1249.       window, you can also enter an alphabetic character.  When GoHome
  1250.       sees that a character has been entered it will run the task
  1251.       corresponding to the position of the character in the alphabet.
  1252.       For instance, press <A> to run the first task, <B> for the second,
  1253.       ..., <Z> for the 26-th task.  Note that this method will only work
  1254.       for the first twenty-six tasks.  Using an alphabetic character may
  1255.       act as a mnemonic for the task to run.  For example, you can assign
  1256.       the fifth task (letter "E") to start you Editor; or assign task 20
  1257.       (letter "T") to run GoEd and load your "To do" list.
  1258.  
  1259.  
  1260.  
  1261.       3.3.6 Using DOS Shell
  1262.  
  1263.       The fifth item in GoHome's main menu is the "DOS Shell" command.
  1264.       This command can be used ANY time you need to get to a DOS prompt.
  1265.       GoHome will swap out the current program and run a copy of DOS's
  1266.       command processor (COMMAND.COM).  When you are done, type "EXIT"
  1267.       followed by <Enter> at the DOS prompt and GoHome will return you to
  1268.       the program you where in.  It is vital that the environment
  1269.       variable "COMSPEC" be set to the path and name of the command
  1270.       processor you are using.  If "COMPSEC" is not set, GoHome may not
  1271.       be able to bring up the DOS prompt.  (To set "COMSPEC", add a
  1272.       statement to your AUTOEXEC.BAT file similar to
  1273.       "COMSPEC=C:\DOS\COMMAND.COM").
  1274.  
  1275.  
  1276.  
  1277.       3.3.7 Using Blank Screen
  1278.  
  1279.       If the same image is displayed on a screen for a long period of
  1280.       time, it may become permanently "burned into" the display.  To help
  1281.       protect your display, GoHome includes a screen blanker.  If, after
  1282.       a pre-defined time (the default is five minutes), a key has not
  1283.       been pressed, GoHome will "blank" (or clear) the screen.  To
  1284.       restore the screen, just hit any key.
  1285.  
  1286.       The sixth item in GoHome's main menu will "blank" the screen
  1287.       immediately.  This is useful if, say, you have some private data on
  1288.       your screen (i.e.  you're playing a game) and someone walks into
  1289.       your office.  You can blank the screen to keep that person from
  1290.       seeing what you are working on.
  1291.  
  1292.       IMPORTANT: Most screen savers that display an animated image on the
  1293.       screen, will halt whatever program is running (i.e.  a tape backup
  1294.       program) when it "kicks" in.  This is not desirable if you plan to
  1295.       schedule programs to run unattended.  GoHome's screen blanker,
  1296.       while not as "pretty" as other screen savers, will NOT interrupt a
  1297.       program that is running.  The program will continue to run even
  1298.       though the screen is blanked.
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.                                        18
  1306.  
  1307.       3.3.8 Using Suspend Tasks
  1308.  
  1309.       There may be times when you are using the computer and a scheduled
  1310.       task is due.  You can use the "Snooze" feature described in the
  1311.       section "Using GoSchedule" to delay the task.  However, you may
  1312.       want to delay all tasks until you finish whatever you may be
  1313.       working on.  The seventh and last item in GoHome's main menu is
  1314.       used to do just this.  When "Suspend Tasks" is selected, GoHome
  1315.       will not run any tasks until you tell it to resume.  Once "Suspend
  1316.       Tasks" has been selected, all items in the main menu, except "Blank
  1317.       Screen" will be disabled and the last item will be changed to
  1318.       "Resume Tasks".  To resume running tasks, just select "Resume
  1319.       Tasks" from the menu.
  1320.  
  1321.       IMPORTANT: If you are going to run a "critical" task such as a disk
  1322.       defragmentor, it if very IMPORTANT that you disable GoHome from
  1323.       interrupting it.  You may do so by selecting "Suspend Tasks" from
  1324.       the menu.  However, a better way is to schedule the task with
  1325.       GoHome (you can still run it manually by using the "Run a Task"
  1326.       command).  GoHome will NOT interrupt a scheduled task.
  1327.  
  1328.       Another method that may be used to keep GoHome from interrupting a
  1329.       program is through the "/SUSPEND" command line parameter.  Let's
  1330.       say that the program you want to run is called DEFRAG.  Create a
  1331.       batch file that contains the following lines.
  1332.  
  1333.            GOHOME /SUSPEND=Y
  1334.            DEFRAG
  1335.            GOHOME /SUSPEND=N
  1336.  
  1337.       The "GOHOME /SUSPEND=Y" line will suspend GoHome from running any
  1338.       tasks, the program will run, and then the line GOHOME /SUSPEND=N"
  1339.       will tell GoHome that it can now run any tasks that are scheduled.
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.                                        19
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.                                    Chapter 4
  1372.  
  1373.                      Using the Program Scheduler - GoSched
  1374.  
  1375.  
  1376.  
  1377.  
  1378.       If you have been following along with this tutorial, you probably
  1379.       already have a good idea of how GoSched works.  In this section, we
  1380.       will point out some of the more interesting and useful features of
  1381.       GoSched.  If you need further information, consult the on-line help
  1382.       for GoSched.
  1383.  
  1384.  
  1385.       4.1 Starting GoSched
  1386.  
  1387.       GoSched can be started two ways: by selecting "GoSchedule" from
  1388.       GoHome's main menu, and running it from the DOS prompt by typing
  1389.       "GOSCHED".  One of GoSched's command line parameters is "/LIST".
  1390.       Using "/LIST" will cause GoSched to display just the Task List and
  1391.       not any of the edit fields (you can toggle displaying the edit
  1392.       fields by pressing the <F5> key).  You may want to use this
  1393.       parameter to have GoSched act as a "Menu" program that will run the
  1394.       task selected by pressing the <F4> key.
  1395.  
  1396.       If GoHome is loaded, GoSched will automatically load the task data
  1397.       file that GoHome is using unless another file is specified on the
  1398.       command line.  Any modifications made to the tasks will take effect
  1399.       as soon as the task file is saved (GoSched will inform GoHome of
  1400.       the changes).
  1401.  
  1402.       If the Edit Fields are displayed, press and hold the <Shift> key
  1403.       and press the up and down arrow keys to move to the next and
  1404.       previous task, respectively.  If the Edit Fields are not display,
  1405.       it is not necessary to hold the <Shift> to move around in the Task
  1406.       List.
  1407.  
  1408.  
  1409.       4.2 Editing Scripts and Batch Files
  1410.  
  1411.       GoSched provides an easy way to edit tasks that are DOS batch files
  1412.       and GoHome script files.  If the task highlighted in the Task List
  1413.       is a batch file, pressing the <F6> key will invoke GoEd with the
  1414.       batch file specified in the "File name" field loaded.  If the task
  1415.       is a Script, the <F6> key will bring up GoScript with the script
  1416.       file specified in the "File name" field loaded.
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.                                        20
  1424.  
  1425.       4.3 Moving Tasks Around
  1426.  
  1427.       Use the Cut and Paste functions to move items within the task list.
  1428.       GoSched has a "Clipboard" buffer that saves the last item that was
  1429.       Cut.  The Paste function copies the contents of this Clipboard into
  1430.       the task position that is highlighted in the "Task List".  For
  1431.       example, to move the 4-th item in the "Task List" to the 10-th
  1432.       position, first use the arrow keys to position the highlight bar
  1433.       over the 4-th item in the "Task List".  Then use the <F7> key to
  1434.       "Cut" this item to the Clipboard.  Now, move to highlight over the
  1435.       10-th item and press the <F8> key to "Paste" the contents of the
  1436.       Clipboard into the 10-th item.
  1437.  
  1438.       If you want to "Copy" the contents of an item, simply use <F7> to
  1439.       Cut followed by <F8> to paste the item back.  Now you can move to
  1440.       the position in the Task List that you want to copy it to.
  1441.  
  1442.  
  1443.       4.4 Getting Help
  1444.  
  1445.       Context sensitive help is available at any time by hitting the <F1>
  1446.       key.  The <F1> key will bring up the help system with the topic set
  1447.       to describe the edit field that the cursor is currently in.  If you
  1448.       need help on how to use the help system, press the <T> key for a
  1449.       list of Topics while in the help system.  Use the arrow keys to
  1450.       scroll up to the first topic "Using Help" and press <E> to expand
  1451.       or read the topic.
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.                                        21
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.                                    Chapter 5
  1490.  
  1491.                        Using the Script Editor - GoScript
  1492.  
  1493.  
  1494.  
  1495.  
  1496.       Most of the time you will create a script using the "Record Script"
  1497.       option in GoHome's main menu.  Once the script is recorded, you may
  1498.       need to edit it to add additional functionality or modify the data
  1499.       that was recorded.
  1500.  
  1501.       The scripts are stored in a "compiled" format.  What this means is
  1502.       that you will not be able to view and edit the scripts using a text
  1503.       editor.  GoHome comes with a program that is used to create and
  1504.       edit these scripts.  The program is named GOSCRIPT.EXE (referred to
  1505.       here as GoScript).
  1506.  
  1507.       GoScript was designed to make the process of creating and editing
  1508.       script files as easy as possible.  For the most part, it is not
  1509.       necessary to memorize all the commands and their parameters.  (If
  1510.       you're familiar with the scripts that most communication programs
  1511.       use, you'll know how hard it is to remember the proper "syntax" for
  1512.       all the commands.  This is especially true since most users tend to
  1513.       write scripts only occasionally).  GoScript uses menus and dialog
  1514.       boxes to prompt for all commands and parameters.  This approach to
  1515.       script file editing makes it easy for first-time users to
  1516.       immediately begin editing scripts.  Most users tend to create a lot
  1517.       of scripts initially and will go a few weeks or more before they
  1518.       have to create or edit another script.  GoScript was designed with
  1519.       these ideas in mind so that it is as simple to use as possible.
  1520.  
  1521.       In this section of the tutorial, we will create a number of scripts
  1522.       that you will be able to use everyday.  We start off with a simple
  1523.       script to enter the time and date into a document and finish with a
  1524.       script that uses a menu and a text file to keep important facts and
  1525.       information at your finger tips.  So let's get started!
  1526.  
  1527.  
  1528.       5.1 Starting GoScript
  1529.  
  1530.       GoScript is started at the DOS prompt by entering "GOSCRIPT"
  1531.       followed by the name of the script file to edit.  If the specified
  1532.       script file is not found, GoScript will create a new script file
  1533.       with the name given.  For example, to create a new script file
  1534.       called "DATE.SCR" enter the following at the DOS prompt.
  1535.  
  1536.              C:> GOSCRIPT date
  1537.  
  1538.  
  1539.  
  1540.  
  1541.                                        22
  1542.  
  1543.       GoScript always assumes a file extension of ".scr".  In the example
  1544.       just given, GoScript will actually create a file named "DATE.SCR".
  1545.  
  1546.  
  1547.       5.2 Example 1 - Typing the Date and Time
  1548.  
  1549.       Let's start off will a simple script to insert the date and time
  1550.       into a document.  We'll call this script "DATETIME.SCR", so start
  1551.       GoScript as follows
  1552.  
  1553.              C:> GOSCRIPT DATETIME
  1554.  
  1555.       NOTE: If you're not in the GoHome directory, you must type the
  1556.       complete path for the script file.
  1557.  
  1558.       GoScript will start up and display a notice window indicating that
  1559.       the script file specified was no found.  Press the <Enter> key and
  1560.       GoScript will create a new script named "DATETIME.SCR".
  1561.  
  1562.       You might want to pause here and examine the items in the menu bar.
  1563.       To access a menu, press and hold the <Alt> key followed by the
  1564.       highlighted letter of the menu bar.  For example, to display the
  1565.       File menu, press and hold the <Alt> key, then press the <F> key,
  1566.       then release both keys.  The up and down arrow keys move the menu's
  1567.       highlight bar; the left and right arrow keys move to the previous
  1568.       and next menu, respectively.
  1569.  
  1570.       The first script command we want to add is the Date command.  To
  1571.       add a script command, display the "Add" menu (press <Alt><A>) then
  1572.       use the arrow keys to position the highlight bar over the "Misc"
  1573.       item.  The arrow head to the right of "Misc" indicates that there
  1574.       is a sub-menu associated with this menu item.  Press <Enter> to
  1575.       display the "Misc" sub-menu.  From this sub-menu, select the
  1576.       "DateStamp" menu item.  The "Date Edit" dialog box will display.
  1577.  
  1578.            ╔═══════════════════ Date Edit ═════════════════════╗
  1579.            ║                                                   ║
  1580.            ║  Enter the date format string  W m D, Y        ▄  ║
  1581.            ║  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  ║
  1582.            ║  Copy to  Keyboard  ▄      OK    ▄   Cancel  ▄    ║
  1583.            ║  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀▀    ║
  1584.            ║  The following characters have special meaning    ║
  1585.            ║  W  -> Week day (ie sun, mon, etc.)               ║
  1586.            ║  M  -> Month as digits                            ║
  1587.            ║  m  -> Month as 3 letter abbrev.                  ║
  1588.            ║  D  -> Day as digits.                             ║
  1589.            ║  Y  -> Year as 4 digits                           ║
  1590.            ║  y  -> Year as 2 digits                           ║
  1591.            ║  $  -> To print the special characters above.     ║
  1592.            ║  any other char is passed through.                ║
  1593.            ║  For example,                                     ║
  1594.            ║  W m D, y     =>  Tue Mar 19, 1993                ║
  1595.            ║  M-D-y        =>  03-19-93                        ║
  1596.            ║  Toda$y is m D, Y =>  Today is Mar 19, 1994       ║
  1597.            ╚═══════════════════════════════════════════════════╝
  1598.  
  1599.  
  1600.                                        23
  1601.  
  1602.       GoScript allows for a number of different date formats.  The first
  1603.       edit field, "Enter the date format string", is used to specify how
  1604.       the date should be displayed.  The text below the edit fields show
  1605.       what characters to use when specifying the date format.  In this
  1606.       example, we want the date to appear in mm/dd/yy format (i.e.
  1607.       03/19/94).  Therefore, we would enter "M/D/y" in the date format
  1608.       field.  When GoHome plays this script, it will substitute the
  1609.       actual month, day, and year in place of the "M" "D" and, "y"
  1610.       characters.  Note that any characters other than "W" "m" "M" "D"
  1611.       "Y" and "y" will be displayed normally.  If you prefer the date to
  1612.       use dashes instead of slashes, type in "M-D-y".
  1613.  
  1614.       Once the date format is entered, hit <Enter> to accept the changes
  1615.       and dismiss the dialog box (hitting enter in a dialog box will
  1616.       execute the default push button, in most cases this will be the
  1617.       "OK" button).  GoScript will insert the Date command into the
  1618.       script.  You should see a line similar to
  1619.  
  1620.              DateStamp+| Sat 03/19/94  (example format) to Keyboard
  1621.  
  1622.       NOTE: GoScript displays a plus sign (+) after the command name
  1623.       whenever a detail edit dialog box is available for that command.
  1624.       To display the dialog box, select "Detail..." from the menu bar or
  1625.       press <Alt><D>.
  1626.  
  1627.       GoScript displays the name of the script command in the left column
  1628.       (i.e.  DateStamp) and the commands parameters to its right.  For
  1629.       the DateStamp command, GoScript displays a sample of what the date
  1630.       format will produce.  The "to Keyboard" at the end of the line,
  1631.       indicates that the date will be placed into the keyboard's buffer.
  1632.       Placing the result in the keyboard's buffer tells GoHome that you
  1633.       want it to simulate typing the date.
  1634.  
  1635.       Let's stop here and verify that this script will result in the
  1636.       current date being typed.  Save the script by pressing "<Alt><F>"
  1637.       to display the "File" menu, and select "Save".  A short cut for
  1638.       saving the file is to press the <F2> key.  Now, exit GoScript by
  1639.       selecting "Exit" from the "File" menu or just hit the <F3> key.
  1640.  
  1641.       You should now be back at the DOS prompt.  GOHOME.EXE must be
  1642.       loaded in memory before any script files can be played back; so if
  1643.       it is not loaded, load it now.
  1644.  
  1645.       To play the DATETIME.SCR script, pop-up GoHome's main menu and
  1646.       select "Playback Script".  Enter "DATETIME" for the script to
  1647.       playback.  GoHome will run the script and it will type in the
  1648.       current date at the DOS prompt.  Verify that, indeed, the current
  1649.       date was typed in the same format that was specified.  You should
  1650.       see something similar to
  1651.  
  1652.            C:\GOHOME> Sat 03/19/94
  1653.  
  1654.       (Your date will, of course, be different.)
  1655.  
  1656.  
  1657.  
  1658.  
  1659.                                        24
  1660.  
  1661.       OK, so far so good.  Run GoScript again with the DATETIME file.
  1662.       This time we'll have the string "Date: " appear before the actual
  1663.       date.  To do this, we'll use the Keys command.  This command is one
  1664.       of the most used script commands because it instructs GoHome to
  1665.       simulate typing all the characters that we tell it to.
  1666.  
  1667.       If the current line indicator (the triangular arrow character in
  1668.       the first column) is not already positioned at the first line, move
  1669.       it there.  Select "Add|Keys".  The Keys detail edit dialog box will
  1670.       appear.  Type "Date: " into the "Keys" edit field.
  1671.  
  1672.            ╔═════════════════════════Key Edit ═══════════════════════╗
  1673.            ║                                                         ║
  1674.            ║ Keys  Date:···········································▄ ║
  1675.            ║  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ║
  1676.            ║    Delay Interval  none  ▄   Default Interval  3▄       ║
  1677.            ║     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀       ║
  1678.            ║              OK    ▄         Cancel  ▄                  ║
  1679.            ║           ▀▀▀▀▀▀▀▀▀▀        ▀▀▀▀▀▀▀▀▀▀                  ║
  1680.            ╚═════════════════════════════════════════════════════════╝
  1681.  
  1682.       The "Delay Interval" field displays the time interval between the
  1683.       current key in the "Keys" field and the character immediately to
  1684.       its right.  The time interval is measured in "ticks" where 1 tick
  1685.       is 1/18 of a second.  When a script is played back, GoHome will
  1686.       "type" a key and then pause for the indicated time interval before
  1687.       "typing" the next key.
  1688.  
  1689.       The "Default Interval" field is used to set the time interval for
  1690.       all new keys that are entered in the "Keys" field.  The default
  1691.       value for this field is 1 ticks.
  1692.  
  1693.       Once "Date: " has been entered, press <Enter> to accept and dismiss
  1694.       the dialog box.
  1695.  
  1696.       NOTE: If GoHome's "Record Script" option was used to record key
  1697.       presses, they could be edited in GoScript using this same process.
  1698.  
  1699.       Press the down arrow key to move just below the DateStamp command.
  1700.       Follow the same procedure to add another Keys command to the script
  1701.       but instead of entering "Date: " in the Keys field, type in " at ".
  1702.  
  1703.       Let's add one more item to the script - a time stamp.  Press the
  1704.       down arrow key to move the current line indicator to the "End of
  1705.       Script" (just below the last Keys command).  Select the
  1706.       "Add|Misc|TimeStamp" option from the menu bar.  The TimeStamp
  1707.       dialog box will be displayed.
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.                                        25
  1719.  
  1720.            ╔═══════════════════ Time Edit ════════════════════╗
  1721.            ║                                                  ║
  1722.            ║   ┌ Time Format ──┐▄   ┌ Time Modifier ──────┐▄  ║
  1723.            ║   │  ( ) HH       │█   │  ( ) 12 hour        │█  ║
  1724.            ║   │  (.) HH:MM    │█   │  (.) 12 hour AM/PM  │█  ║
  1725.            ║   │  ( ) HH:MM:SS │█   │  ( ) 24 hour        │█  ║
  1726.            ║   └───────────────┘█   └─────────────────────┘█  ║
  1727.            ║    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀  ║
  1728.            ║               Copy to  Keyboard  ▄               ║
  1729.            ║               ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀               ║
  1730.            ║                                                  ║
  1731.            ║               OK    ▄       Cancel  ▄            ║
  1732.            ║            ▀▀▀▀▀▀▀▀▀▀      ▀▀▀▀▀▀▀▀▀▀            ║
  1733.            ╚══════════════════════════════════════════════════╝
  1734.  
  1735.       This dialog box allows the time format to be selected.  The default
  1736.       format is "HH:MM" with hours displayed in 12 hour format and am/pm
  1737.       indicated (i.e.  1:31 pm).  Let's just use the default format.  Hit
  1738.       <Enter> to accept and dismiss the dialog box.  The completed script
  1739.       is shown below.
  1740.  
  1741.            1.   Keys      │Date:
  1742.            2.   DateStamp │03/19/94  (example format) to Keyboard
  1743.            3.   Keys     +│ at
  1744.            4.   TimeStamp │HH:MM am/pm to Keyboard
  1745.            5.             │     <<    End Of Script    >>
  1746.  
  1747.       Once again, save the script and exit GoScript.  Use GoHome to run
  1748.       the script and verify that it types in something similar to
  1749.  
  1750.            Date: 03/19/94 at 1:23 pm
  1751.  
  1752.       The preceding may read long but once you are familiar with GoScript
  1753.       you'll be able to create scripts in very little time.  GoScript
  1754.       makes it easy because it doesn't require you to remember the
  1755.       command names and the parameters that go with it.  In other words,
  1756.       GoScript won't allow you to make any mistakes when editing a
  1757.       script.
  1758.  
  1759.       There wouldn't be much point in writing a script to type in the
  1760.       date and time at the DOS prompt.  As it turns out, we can use this
  1761.       script to insert the date and time into any program we happen to
  1762.       use.  To try this, start up GoEd
  1763.  
  1764.            C:\GOHOME> GOED TEST.TXT
  1765.  
  1766.       Now play back the script again.  GoHome will insert the date and
  1767.       time into the editor, just as if you typed it in!  Try running the
  1768.       script with your word processor to verify that it indeed works.
  1769.       (GoHome has been tested with a number of applications, it is
  1770.       possible, however, that one of your applications is incompatible
  1771.       with the way GoHome enters the keystrokes.  If this is the case,
  1772.       please contact Added Dimension Software and tell us what program
  1773.       you are having problems with).
  1774.  
  1775.  
  1776.  
  1777.                                        26
  1778.  
  1779.       If this script is something that you'll use often, you can save
  1780.       yourself from having to type in the name of the script file every
  1781.       time you run it by adding a task to GoSched that will run the
  1782.       script.  The script can then be executed by popping GoHome up,
  1783.       hitting <R> to run a task, and typing in the number of the task.
  1784.  
  1785.       To add the DATETIME script to GoSched:
  1786.  
  1787.       1.  Run GoSched by selecting "GoSchedule" from GoHome's main menu.
  1788.  
  1789.       2.  Go to a task that is not being used.
  1790.  
  1791.       3.  Enter a description (if you want, it's not necessary).
  1792.  
  1793.       4.  Select "Script File" from the Task Type drop-down list.
  1794.  
  1795.       5.  Enter the complete path and name of the script file (i.e.
  1796.           \GOHOME\DATETIME.SCR) in the "File Name" edit field.
  1797.  
  1798.       6.  Press <Alt>O to bring up the "Options" dialog box.  Remove the
  1799.           check mark in the "Start Script at DOS prompt" field (use the
  1800.           space bar to toggle check marks).  Place a check mark in the
  1801.           "No countdown window".
  1802.  
  1803.       7.  Press <F2> to save the file and then <F3> to exit GoSched.
  1804.  
  1805.  
  1806.       5.3 Example 2 - Writing the Date and Time to a File
  1807.  
  1808.       In this example, we'll modify the script created in Example 1 to
  1809.       write the date/time stamp to a file.  Generally, the script
  1810.       presented here would be part of a larger script.  For example, say
  1811.       you have a script that dials into a BBS and captures to a file the
  1812.       latest stock quotes.  Before dialing, you may want to write a small
  1813.       section header to the capture file that contains the date and time
  1814.       the call was made.
  1815.  
  1816.       This script will write out the following two lines to a file named
  1817.       C:\STCKQTES.TXT
  1818.  
  1819.            +++++++++++++++++++++++++++++++++++++++
  1820.            Stock Quotes current as of: 03/19/94 at 1:00 am
  1821.  
  1822.       Before we discuss the steps necessary to create this script, we
  1823.       need to first discuss GoScript's program variables.
  1824.  
  1825.  
  1826.  
  1827.       5.3.1 Script Variables
  1828.  
  1829.       GoHome uses five program variables.  A program variable is used to
  1830.       store a specific piece of data.  Depending on the variable, the
  1831.       data may be numeric or a text string.  Two of the variables contain
  1832.       numeric values that are set and maintained by GoHome, the other
  1833.       three variables contain text strings that can be modified by the
  1834.  
  1835.  
  1836.                                        27
  1837.  
  1838.       script in any manner it sees fit.  These text string variables can
  1839.       be extremely useful when writing scripts as we'll soon see.  The
  1840.       following table lists the names and purposes of these variables.
  1841.  
  1842.            Variable    Purpose
  1843.            ----------------------------------------------------------
  1844.            Result      Set to "OK", "Not OK", or "Timed Out"
  1845.                        depending on whether the last script
  1846.                        command was successful, not successful, or
  1847.                        timed out, respectively.
  1848.            MenuItemSel Contains the last menu item selected from
  1849.                        a DoMenu script command. Valid values are
  1850.                        "None" if user canceled menu (i.e. hit ESC
  1851.                        key), and 1, 2, ..., 9.
  1852.            StringA     These are general purpose string
  1853.            StringB     variables. Each may contain up to 80
  1854.            StringC     characters. Any strings that are copied to
  1855.                        these variables may contain an embedded
  1856.                        macro. An embedded macro is either another
  1857.                        string variable or an environment
  1858.                        variable. These macros are denoted by
  1859.                        prefacing them with percent signs ("%').
  1860.                        For example, if StringA contains the
  1861.                        string "Hello", and there's an environment
  1862.                        variable "COMSPEC" that contains
  1863.                        "C:\COMMAND.COM" then the following
  1864.                        strings would be expanded as shown.
  1865.  
  1866.                    "%StringA, World!"    => "Hello, World!"
  1867.                    "Say %StringA to all" => "Say Hello to all"
  1868.                    "Comspec is %comspec  => "Comspec is C:\COMMAND.COM"
  1869.  
  1870.       GoHome also allows the following macro characters to be used within
  1871.       strings:
  1872.  
  1873.            %CR Carriage return character
  1874.            %NL New-line character
  1875.            %CN Both carriage return and new-line characters
  1876.            %FF Form-feed character
  1877.            %TB Tab character
  1878.            %#n Character represented by ASCII number, "n"
  1879.  
  1880.       These macros are especially useful when writing strings to the
  1881.       printer or a file.  For example, the following could be used to
  1882.       send the contents of StringA to a file or printer:
  1883.  
  1884.            "%stringa%CN"
  1885.  
  1886.       All the variables and macro characters are case insensitive.
  1887.  
  1888.       In this example script, we'll use script variables to construct the
  1889.       date/time stamp line.  It's important that you followed (or at
  1890.       least read) Example 1 and understand Script Variables before trying
  1891.       to follow this example.
  1892.  
  1893.  
  1894.  
  1895.                                        28
  1896.  
  1897.       5.4 Example 2 - Continued
  1898.  
  1899.       Since this script is similar to the script created in Example 1,
  1900.       we'll use that script to get us going.  So, copy that script to
  1901.       another file and call it DT2FILE.SCR (to copy the file, type "COPY
  1902.       DATETIME.SCR DT2FILE.SCR" at the DOS prompt).
  1903.  
  1904.       Start GoScript with the new script file:
  1905.  
  1906.            C:\GOHOME> GOSCRIPT DT2FILE
  1907.  
  1908.       It's a good idea to make a note of what a script does, so when we
  1909.       happen to look at it later, it'll jog our memory.  GoScript has a
  1910.       script command, "Comment", that allows us to do just that.  Note
  1911.       that it's not really a "command" in the sense that it doesn't
  1912.       actually do anything.  Let's add a Comment as the first line in the
  1913.       script.  To do this, select "Add|Comment".  A Comment command will
  1914.       be entered into the script.  Note that this command doesn't have a
  1915.       detail edit dialog box; we can type in the comment directly into
  1916.       the edit field displayed next to the command name.  Type in the
  1917.       following for the comment:
  1918.  
  1919.            "This script writes the current date and time to a file."
  1920.  
  1921.       We don't need the two Keys command, so delete them by selecting
  1922.       "Edit|Delete Line" or just press the <F5> key.
  1923.  
  1924.       Move to the DateStamp line and select the "Detail..." option in the
  1925.       menu bar (press <Alt><D>).  In the detail edit dialog box for the
  1926.       DateStamp, TAB to the field labeled "Copy to".  Press the down
  1927.       arrow key to display the menu, select "StringA", and then hit
  1928.       <Enter>.  Accept and dismiss the dialog box by tabbing to the "OK"
  1929.       button and hitting <Enter>.
  1930.  
  1931.       Follow the same procedure for the TimeStamp command but select
  1932.       "StringB" in the "Copy to" field.
  1933.  
  1934.       Move to the line following the TimeStamp command and select
  1935.       "Add|Copy".  This will display the "Copy" dialog box.
  1936.  
  1937.       The Copy command is very versatile.  It allows for the values of
  1938.       script variables, text strings, and environment variables to be
  1939.       copied to a script variable, typed automatically at the keyboard,
  1940.       copied to an environment variable, copied to a file, displayed on
  1941.       the screen, or sent to a printer.  You indicate what to copy "From"
  1942.       and "To" by selecting the proper radio button in the Copy dialog
  1943.       box.  For this Copy command, we want to copy a string of plus signs
  1944.       to a file.  These plus signs help us to find the start of a section
  1945.       (i.e.  beginning of stock quotes for the current day).
  1946.  
  1947.       Press the down arrow key to move to the "String" field in the
  1948.       "From" group box.  Press the space bar to toggle the radio button.
  1949.       Next, hit <Tab> twice to move to the edit field to the right of the
  1950.       "String" radio button and type in a number of plus (+) signs and
  1951.       then type in "%CN".
  1952.  
  1953.  
  1954.                                        29
  1955.  
  1956.       We want to copy this string to a file named, "STCKQTES.TXT".  To do
  1957.       this, press <Alt><F> to move to the "File" radio button in the
  1958.       "From" group box.  Press the space bar to toggle the radio button.
  1959.       Press <Tab> twice to move to the field that is just to the right of
  1960.       "File" and type, "STCKQTES.TXT".  The dialog box should look like
  1961.  
  1962.            ╔═════════════════════ Copy ════════════════════════╗
  1963.            ║                                                   ║
  1964.            ║      ┌ From ───────────────────────────────┐▄     ║
  1965.            ║      │( ) Variable   String A              │█     ║
  1966.            ║      │(.) String     ++++++++++++++++++%CN │█     ║
  1967.            ║      │( ) Environment Variable             │█     ║
  1968.            ║      └─────────────────────────────────────┘█     ║
  1969.            ║       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀     ║
  1970.            ║      ┌ To ─────────────────────────────────┐▄     ║
  1971.            ║      │( ) Variable   String A              │█     ║
  1972.            ║      │( ) Keyboard                         │█     ║
  1973.            ║      │( ) Environment Table                │█     ║
  1974.            ║      │(.) File       c:\\stckqtes.txt····  │█     ║
  1975.            ║      │( ) Display   row=      col=         │█     ║
  1976.            ║      │( ) Printer                          │█     ║
  1977.            ║      └─────────────────────────────────────┘█     ║
  1978.            ║       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀     ║
  1979.            ║                 OK    ▄       Cancel  ▄           ║
  1980.            ║              ▀▀▀▀▀▀▀▀▀▀      ▀▀▀▀▀▀▀▀▀▀           ║
  1981.            ╚═══════════════════════════════════════════════════╝
  1982.  
  1983.       Press <Alt><O> (OK Button) to accept the changes and dismiss the
  1984.       dialog box.
  1985.  
  1986.       Add another "Copy" command just below the one just entered.  Follow
  1987.       the same procedure but type the following into the String edit
  1988.       field.
  1989.  
  1990.            Stock Quotes current as of: %StringA at %StringB %CN
  1991.  
  1992.       When GoHome plays this script, it will substitute the values
  1993.       contained in variables StringA (the DateStamp) and StringB (the
  1994.       TimeStamp) in place of "%StringA" and "%StringB", respectively.  It
  1995.       will also replace "%CN" with carriage-return and new-line
  1996.       characters.  The carriage-return and new-line characters are
  1997.       necessary to mark the end of a line in a text file.
  1998.  
  1999.       Save the script file by selecting "File|Save".  The completed
  2000.       script should look similar to
  2001.  
  2002.            1.   Comment   │This script writes the current date and time
  2003.                to a file.
  2004.            2.   DateStamp │03/19/94  (example format) to String A
  2005.            3.   TimeStamp │HH:MM am/pm to String B
  2006.            4.   Copy      │"++++++++++++++++++++++%CN" to file C:\stckqtes
  2007.            5.   Copy     +│"Stock Quotes current as of: %StringA at
  2008.                                                    %StringB%CN" to file
  2009.            6.             │     <<    End Of Script    >>
  2010.  
  2011.  
  2012.  
  2013.                                        30
  2014.  
  2015.       NOTE: The text displayed in the DateStamp Parameter field will be
  2016.       different.
  2017.  
  2018.       Hopefully you're starting to understand how to add commands to a
  2019.       script and edit the command's parameters.  So that we don't bore
  2020.       you any more with all the little details the previous examples went
  2021.       through, the following examples will just list the script file and
  2022.       touch on a few of the more important points.
  2023.  
  2024.  
  2025.       5.5 Example 3 - Viewing the Log File
  2026.  
  2027.       The script in this example will display the contents of the log
  2028.       file.  Recall that the name of the log file depends on the current
  2029.       month and year.  If today is March 19, 1994, the log file would be
  2030.       named GO_03-94.LOG.  We'll use GoHome's string and date handling
  2031.       abilities to create the log file name and then start up GoEd to
  2032.       display the log file.  Let's also assume that we want GoEd to exit
  2033.       if a key is not pressed within 30 seconds.  If a key is entered,
  2034.       then we'll terminate the script and let the user exit GoEd
  2035.       manually.
  2036.  
  2037.       Example 3 Script (line numbers added to facilitate discussion):
  2038.  
  2039.            1.   Comment   │ ** View the current GoHome log file **
  2040.            2.   DateStamp │ 11-94  (example format) to String A
  2041.            3.   Copy      │ "C:\GOHOME\GO_%stringa.log" to String B
  2042.            4.   Copy      │ "GOED %stringb %CR" to Keyboard
  2043.            5.   Delay     │ 0 minutes  5 seconds
  2044.            6.   GetKey    │ timeout=30
  2045.            7.   IfGoto    │ if Result is Not Equal to/than Timed out
  2046.                               then goto END
  2047.            8.   Comment   │ ** We timed-out before a key was entered,
  2048.                               exit app **
  2049.            9.   Keys      │ <Alt-X>
  2050.            10.  Label     │ END
  2051.            11.            │     <<    End Of Script    >>
  2052.  
  2053.       Example 3 script line by line:
  2054.  
  2055.       1.  The first line in the script is a comment to let us know what
  2056.           the script does.
  2057.  
  2058.       2.  Lines 2 and 3 construct the name of the log file.  The
  2059.           DateStamp command is used to form the date part of the name.
  2060.           In the detail dialog box, enter "M-y" in the "Enter the date
  2061.           format string" field.  Make sure that StringA is selected in
  2062.           the "Copy To" drop-down field.
  2063.  
  2064.       3.  Line 3 uses the Copy command to append the path and starting
  2065.           characters to the date string stored in StringA (GoHome will
  2066.           replace %stringa with the data stored in the script variable,
  2067.           StringA).  This new string is stored in variable, StringB.
  2068.  
  2069.  
  2070.  
  2071.  
  2072.                                        31
  2073.  
  2074.           Select the "String" radio button and enter
  2075.           "C:\GOHOME\GO_%StringA" into the field to its right.  Then
  2076.           select the "Variable" field in the "To" group box and select
  2077.           StringB from the drop down list beside it.
  2078.  
  2079.       4.  Line 4 will start GoEd (we're assuming that GOED.EXE is in your
  2080.           PATH statement) with the log file loaded.  We again use the
  2081.           Copy command to create a new string that adds "GOED" to the
  2082.           front of the log file and the carriage-return character (uses
  2083.           %CR macro) to the end.  The carriage-return character acts the
  2084.           same way that the <Enter> key does.  This new string is then
  2085.           copied to the keyboard, which will simulate "typing" the
  2086.           characters from the keyboard.  You may have noticed that lines
  2087.           3 and 4 could easily be combined into one Copy command such as:
  2088.  
  2089.                Copy │GOED C:\GOHOME\GO_%stringa.log %CR to Keyboard
  2090.  
  2091.           This has the same effect and is easier to understand than the
  2092.           two step method presented in the listing.  The method in the
  2093.           listing was used to show how multiple script variables can be
  2094.           used to append strings.
  2095.  
  2096.       5.  Line five delays (or pauses) playing the script for 5 seconds.
  2097.           This is necessary in order to give GOED enough time to start up
  2098.           and load the log file.
  2099.  
  2100.       6.  Line 6 uses the GetKey command ("Add|Misc Keys|GeKey") to wait
  2101.           for a key to be entered.  A time out value of 30 seconds is
  2102.           used.  If a key is not pressed within 30 seconds, GetKey will
  2103.           set the script variable, "Result", to "TimedOut" and return.
  2104.           If you don't want to have GetKey time out, set the time out
  2105.           value to 0 seconds.  It is important to note that GetKey will
  2106.           not allow the current application to run while it is waiting
  2107.           for a key to be entered.  If we didn't use the Delay command in
  2108.           line 5, GoEd would not be able to finish loading the log file
  2109.           because GetKey pauses or halts the application.  Delay, on the
  2110.           other hand, does not pause the application and, therefore, GoEd
  2111.           is able to load the file while the Delay command is active.
  2112.  
  2113.       7.  Line 7 uses the IfGoto command to determine if the GetKey
  2114.           command timed out.  If it did, then we want to exit GoEd and
  2115.           return to the DOS prompt.  If a key was entered, we want to
  2116.           terminate the script without exiting GoEd.  The IfGoto command
  2117.           should be used any time its necessary to skip some commands
  2118.           based on some value of a script variable.  The IfGoto command
  2119.           uses four parameters: the script variable to test, the value to
  2120.           compare the script variable against, the test condition to be
  2121.           met, and a label to go to if the test is successful.
  2122.  
  2123.           The script variable can be any one of the five: Result,
  2124.           MenuItemSel, StringA, StringB, or StringC (see section "Script
  2125.           Variables" for additional details).
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.                                        32
  2132.  
  2133.           The test condition depends on the variable selected.
  2134.           Generally, you can test if the script variable is equal to or
  2135.           not equal to a specified value.
  2136.  
  2137.           The value, like the test condition, depends on the variable
  2138.           selected.  If the variable is Result, then value can be either
  2139.           OK, meaning that the last command completed successfully, Not
  2140.           OK if command didn't execute correctly, or Timed Out.  If the
  2141.           variable is Menu Item Sel, then value can be a number between 1
  2142.           and 9 or None.  For any of the string variables, value can be
  2143.           any other string variable, an empty or blank string, or any
  2144.           text you type into the value edit field (the value field is
  2145.           both a drop-down list and an edit field when the variable is
  2146.           one of the string variables).
  2147.  
  2148.           A label in GoScript defines a location in the script (if you're
  2149.           familiar with DOS batch files, a label in GoScript is similar
  2150.           to a label in a batch file).  Each label is assigned a unique
  2151.           name.  Labels are added to a script by selecting "Add|Label".
  2152.           The IfGoto command must be supplied with a label to jump or
  2153.           goto when the test is met.  The IfGoto detail dialog box allows
  2154.           for labels to be assigned in two ways: by typing the name of
  2155.           the label into the Label edit field, or pressing the
  2156.           "Labels..." button (<Alt><L>) to invoke the label maintenance
  2157.           dialog box and selecting a label from there.
  2158.  
  2159.           For this example, select "Result" for the variable, "Not Equal"
  2160.           for the test condition, "Timed out" for the value, and enter
  2161.           "END" in the Label field.  The figure below shows how the
  2162.           IfGoto dialog box should appear.
  2163.  
  2164.                ╔════════════════════════ If Goto ════════════════════════╗
  2165.                ║                                                         ║
  2166.                ║    Variable:            Test Condition:    Value:       ║
  2167.                ║ If Result           ▄   Not Equal      ▄   Timed out▄   ║
  2168.                ║    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀▀▀   ║
  2169.                ║    then goto Label   END             ▄    Labels... ▄   ║
  2170.                ║                      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀▀▀▀   ║
  2171.                ║                                                         ║
  2172.                ║                   OK    ▄     Cancel  ▄                 ║
  2173.                ║                ▀▀▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀▀▀                 ║
  2174.                ╚═════════════════════════════════════════════════════════╝
  2175.  
  2176.       8.  Line 8 is a comment.
  2177.  
  2178.       9.  Line 9 will be executed ONLY if the test condition in the
  2179.           IfGoto command is NOT met.  In this case, line 9 will be
  2180.           executed only if the GetKey command happened to time out.  When
  2181.           this happens, we want to exit GoEd.  This is normally done by
  2182.           pressing <Alt><X> or <F3>.  To have GoHome do it for us, we
  2183.           must use the Keys command.  After the Keys command has been
  2184.           added, its detail dialog box will appear.  Because GoScript
  2185.           uses <Alt> key combinations to move the cursor to edit fields
  2186.           or to invoke a menu, we must tell GoScript to temporarily
  2187.           ignore any of its normal edit keys.  We can do this by pressing
  2188.  
  2189.  
  2190.                                        33
  2191.  
  2192.           <Shift><Ins> (press and hold the <Shift> key, then press
  2193.           <Ins>).  Now, any key we press will be accepted as a key for
  2194.           the Keys field and not as a GoScript edit key.  This same
  2195.           procedure must also be used to enter the arrow keys, function
  2196.           keys, Home, End, Delete, etc.  Once <Shift><Ins> has been
  2197.           pressed, press the key combination that makes GoEd quit,
  2198.           <Alt><X> (or press <F3>).  Then, to get back into normal edit
  2199.           mode, press <Shift><Ins> again.
  2200.  
  2201.       10. The last command in this script is a label or position marker.
  2202.           This is the same label that was used in the IfGoto command.
  2203.           When the Label is added ("Add|Label"), the Label Maintenance
  2204.           dialog box is displayed.  This dialog displays a list of labels
  2205.           that have been used in IfGoto and Goto commands but have not
  2206.           been added to the script.  To select a label from the list, use
  2207.           the up and down arrow keys to select the label, then, push the
  2208.           "Use" button (<Alt>U).  To add a new label to the list, push
  2209.           the "Add" button.  If a label is not referenced in the script,
  2210.           a dash (-) will appear to its left.
  2211.  
  2212.           For this example, press <Alt><U> to use "END" as our label
  2213.           name.
  2214.  
  2215.                ╔════════════ Label Maintenance ═══════════╗
  2216.                ║                                          ║
  2217.                ║  ┌────── Label ──────┐                   ║
  2218.                ║  │- END              ▓        Add... ▄   ║
  2219.                ║  │                   ▓      ▀▀▀▀▀▀▀▀▀▀   ║
  2220.                ║  │                   ▓       Remove  ▄   ║
  2221.                ║  │                   ▓      ▀▀▀▀▀▀▀▀▀▀   ║
  2222.                ║  │                   ▓        Use    ▄   ║
  2223.                ║  │                   ▓      ▀▀▀▀▀▀▀▀▀▀   ║
  2224.                ║  │                   ▓        Done   ▄   ║
  2225.                ║  └──────────────────        ▀▀▀▀▀▀▀▀▀▀   ║
  2226.                ║   -: label not in script                 ║
  2227.                ╚══════════════════════════════════════════╝
  2228.  
  2229.       Note: A similar script could also be used to delete the log file at
  2230.       the end of each month.
  2231.  
  2232.  
  2233.       5.6 Example 4 - Taking a Screen Snapshot
  2234.  
  2235.       This script is very useful to help copy portions of a screen to a
  2236.       file.  In fact, all the screen shots in this document were captured
  2237.       using this script.  This script uses only two commands.  The
  2238.       GetArgument command prompts for a file name to save the screen
  2239.       snapshot to, and the TaskSnapshot command saves a portion of the
  2240.       screen to that file.
  2241.  
  2242.       The script is shown below.
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.                                        34
  2250.  
  2251.            1.   Comment     │Save a portion of the image to a file
  2252.            2.   GetArgument │ArgNumber=1  Prompt=Save to file  t.o.=0
  2253.                              copy to String A
  2254.            3.   TakeSnapshot│r= 1 c= 1 w=80 h=25 attrs=0 i=1
  2255.                              file=%stringa
  2256.            4.               │     <<    End Of Script    >>
  2257.  
  2258.       1.  A comment telling us what the script does.
  2259.  
  2260.       2.  The GetArgument command requires that four parameters be
  2261.           specified.  The first parameter is the argument number.  An
  2262.           argument may be specified on the same line as the script file.
  2263.           For example, if a script is named MYSCRIPT.SCR, we could enter
  2264.           the following line when a script file is specified (from
  2265.           GoHome's "Playback Script" or when a script is scheduled in
  2266.           GoSched)
  2267.  
  2268.                MYSCRIPT.SCR  JOHN SMITH, TEXAS
  2269.  
  2270.           ArgNumber 0 always refers to the name of the script file.  All
  2271.           other arguments must be comma separated text strings.
  2272.           Therefore, argument number 1 is "JOHN SMITH", and argument
  2273.           number 2 is "TEXAS".  If we were to ask for argument number 5,
  2274.           GoHome would first check to see if at least five arguments were
  2275.           specified with the script file, if not, it would pop-up a small
  2276.           dialog box and prompt for the argument.
  2277.  
  2278.           The second parameter of the Argument command is for the prompt
  2279.           to display in the dialog box that is used to get the argument.
  2280.           The dialog box is only used when the argument is not specified
  2281.           along with the script file name.
  2282.  
  2283.           The third parameter is used to specify a time out value.  Like
  2284.           all time out values, this is specified in seconds and a 0
  2285.           second value is interpreted to mean "do not time out".
  2286.  
  2287.           The fourth and final parameter specifies where the argument is
  2288.           to go: the keyboard or one of the String variables.
  2289.  
  2290.           For this script, add an Argument command with an argument
  2291.           number equal to 1, for the prompt enter "Save to file", select
  2292.           StringA in the copy to field, and set the time out value to 0.
  2293.           The Argument detail dialog should appear as shown below.
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.                                        35
  2309.  
  2310.                ╔═══════════ Get Argument ═════════════╗
  2311.                ║                                      ║
  2312.                ║    Argument Number  1· ▄             ║
  2313.                ║    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀             ║
  2314.                ║    Prompt   Save to file         ▄   ║
  2315.                ║    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀   ║
  2316.                ║    Copy to  String A  ▄              ║
  2317.                ║    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀              ║
  2318.                ║    Timeout  0     ▄                  ║
  2319.                ║    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀                  ║
  2320.                ║                                      ║
  2321.                ║           OK    ▄     Cancel  ▄      ║
  2322.                ║        ▀▀▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀▀▀      ║
  2323.                ╚══════════════════════════════════════╝
  2324.  
  2325.       3.  TakeSnapshot is the third and last command in this script.  It
  2326.           is used to save a portion of the screen to a file.
  2327.           TakeSnapshot requires seven parameters.  You specify the
  2328.           top-most row, left-most column, width, and height for the
  2329.           section of the screen that should be saved, whether to save the
  2330.           video attributes (i.e.  colors), allow the section of the
  2331.           screen to be selected interactively, and the name of the file
  2332.           to save the screen to.  TakeSnapshot doesn't have a detail
  2333.           dialog box because the parameters can be entered next to the
  2334.           command.  Rows (r) range from 1 to the number of lines on the
  2335.           screen, typically 25.  Columns (c) range from 1 to the number
  2336.           of columns that can be displayed, usually 80.  The width and
  2337.           height are denoted on the edit line by a "w" and "h"
  2338.           respectively.  If attributes are to be saved, enter a 1 the
  2339.           attrs field; to save just the text, enter 0.  Similarly, enter
  2340.           a 1 in the "i" (or interactive) field to allow the user to
  2341.           designate the portion of the screen interactively.  Finally,
  2342.           the file field is for the file name which accepts a string
  2343.           variable or a specific file name.
  2344.  
  2345.           For this example, add a TakeSnapshot command
  2346.           ("Add|Misc|TakeSnapshot").  Since we want to select the region
  2347.           interactively, we can just leave the r, c, w, and h fields as
  2348.           they are (they are used only for non- interactive regions).
  2349.           Enter a 0 in the "attrs" field and a 1 in the "i" field.  Since
  2350.           we've prompted for the file name with the Argument command and
  2351.           saved it in the StringA variable, specify %StringA for the file
  2352.           name.  That's it.  You now have a way to "cut-n-paste" text
  2353.           between applications.
  2354.  
  2355.           One more thing needs to be mentioned before moving on.
  2356.           TakeSnapshot has a compliment command called PutSnapshot.
  2357.           PutSnapshot displays the screen saved with TakeSnapshot.
  2358.           PutSnapshot takes just one parameter, the name of the file to
  2359.           display.  PutSnapshot knows where to place the image because
  2360.           TakeSnapshot saves the row, column, width, height and video
  2361.           attribute data as the first 6 characters of the file.  If you
  2362.           are capturing date to be copied into a word processor, you'll
  2363.           need to delete these six characters using the word processor.
  2364.  
  2365.  
  2366.  
  2367.                                        36
  2368.  
  2369.       5.7 Example 5 - Writing a "Macro" Menu
  2370.  
  2371.       In this example, we create a menu that can be used to initiate a
  2372.       number of functions.  When this script is run, a menu will pop-up
  2373.       and perform the action corresponding to the menu item selected.
  2374.       The following table lists the menu items and their actions that
  2375.       this script implements.
  2376.  
  2377.            Menu Item        Action
  2378.            ---------------------------------------------------
  2379.            Name             Type "Added Dimension Software"
  2380.            Address          Type an address
  2381.            Today's Date     Type the current date
  2382.                             similar to "Sat Mar 19, 1994
  2383.            Start Editor     Type in "GOED<Enter>" (must be
  2384.                             at DOS prompt)
  2385.            Run Task 1       Run the first task in GoSched's
  2386.                             Task List
  2387.            sDate/Time Stamp  Execute the script, "DATETIME.SCR"
  2388.  
  2389.       Let's look at the script first, and then we'll discuss it (if you
  2390.       installed the example scripts, this is script "EXAMPLE5.SCR".
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.                                        37
  2427.  
  2428.       1.    Comment │** This script uses a menu to playback
  2429.                          keyboard macros"
  2430.       2.    Comment │
  2431.       3.   KeySpeed │  0 timer ticks
  2432.       4.     DoMenu │  Macro Menu   t.o.=0
  2433.       5.     IfGoto │if Menu Item Sel is Equal to/than None then
  2434.                         goto END
  2435.       6.     IfGoto │if Menu Item Sel is Greater to/than 1 then
  2436.                        goto Try 2
  2437.       7.       Keys │Added Dimension Software
  2438.       8.       Goto │END
  2439.       9.      Label │Try 2
  2440.       10.    IfGoto │if Menu Item Sel is Greater to/than 2 then
  2441.                         goto Try 3
  2442.       11.      Keys │6780 Abrams. Rd.<Enter>Suite 103-190<Enter>Dallas,
  2443.       12.      Keys │TX  75231<Enter> (214) 341-5759
  2444.       13.      Goto │END
  2445.       14.     Label │Try 3
  2446.       15.    IfGoto │if Menu Item Sel is Greater to/than 3 then
  2447.                         goto Try 4
  2448.       16. DateStamp │Thr Jan 20, 1994  (example format) to Keyboard
  2449.       17.      Goto │END
  2450.       18.     Label │Try 4
  2451.       19.    IfGoto │if Menu Item Sel is Greater to/than 4 then
  2452.                         goto Try 5
  2453.       20.   Comment │NOTE: The following Keys statement assumes you
  2454.       21.   Comment │      are at the DOS Prompt.
  2455.       22.      Keys │goed c:\autoexec.bat<Enter>
  2456.       23.      Goto │END
  2457.       24.     Label │Try 5
  2458.       25.    IfGoto │if Menu Item Sel is Greater to/than 5 then
  2459.                         goto Try 6
  2460.       26.   RunTask │taskNum=1
  2461.       27.      Goto │END
  2462.       28.     Label │Try 6
  2463.       29.    IfGoto │if Menu Item Sel is Greater to/than 6 then
  2464.                         goto Try 7
  2465.       30.   ChainTo │c:\gohome\examples\example1.scr
  2466.       31.      Goto │END
  2467.       32.     Label │Try 7
  2468.       33.     Label │END
  2469.       34.           │     <<    End Of Script    >>
  2470.  
  2471.       I'm sure you've noticed is that it is quite a bit longer than any
  2472.       of the previous examples.  However, most of the script contains a
  2473.       repetitive sequence of commands.  Let's first examine the DoMenu
  2474.       command.
  2475.  
  2476.       The DoMenu command allows for up to 10 menu items to be entered.
  2477.       When GoHome comes to a DoMenu command, it displays a menu with the
  2478.       given menu items.  After the user selects a menu item, GoHome
  2479.       closes the menu and sets the "Menu Item Sel" variable to the number
  2480.       of the menu item selected.  There are two exceptions to this,
  2481.       however: if <Esc> is pressed, "Menu Item Sel" is set to "None"; and
  2482.  
  2483.  
  2484.  
  2485.                                        38
  2486.  
  2487.       if the specified time out period elapses, "Menu Item Sel" is set to
  2488.       "Timed Out".
  2489.  
  2490.       The detail edit dialog box for this example appears as:
  2491.  
  2492.            ╔════════════ DoMenu Edit ═══════════╗
  2493.            ║                                    ║
  2494.            ║       ╒════   Macro Menu·· ══╕     ║
  2495.            ║     1 │ N  Name              │     ║
  2496.            ║     2 │ A  Address           │     ║
  2497.            ║     3 │ D  Today`s Date      │     ║
  2498.            ║     4 │ W  Start Word Proc   │     ║
  2499.            ║     5 │ R  Run Task 1        │     ║
  2500.            ║     6 │ T  Date/Time Stamp   │     ║
  2501.            ║     7 │                      │     ║
  2502.            ║     8 │                      │     ║
  2503.            ║     9 │                      │     ║
  2504.            ║       └──────────────────────┘     ║
  2505.            ║         ^── Enter HotKey char      ║
  2506.            ║                                    ║
  2507.            ║           Timeout  0     ▄         ║
  2508.            ║           ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀         ║
  2509.            ║           OK    ▄    Cancel  ▄     ║
  2510.            ║        ▀▀▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀▀▀     ║
  2511.            ╚════════════════════════════════════╝
  2512.  
  2513.       You type in the menu title and each menu item.  The first character
  2514.       in each menu item is the key that acts as the HotKey.  For example,
  2515.       if <D> is pressed when the menu is displayed, the third menu item
  2516.       is selected.  If a time out value is needed, specify it in the Time
  2517.       Out field.
  2518.  
  2519.       The command just prior to DoMenu is KeySpeed.  KeySpeed is used to
  2520.       modify the rate at which keys are played back.  A value of 0 will
  2521.       cause GoHome to play the keys as fast as the program can read them
  2522.       in.  If KeySpeed is assigned -1, then the keys are played back as
  2523.       they were recorded or edited.  Any other number will delay that
  2524.       number of ticks (1/18 of a second) between each key.  In this
  2525.       example, we set KeySpeed to 0 so that GoHome will "type" the keys
  2526.       as fast as possible.
  2527.  
  2528.       The rest of the script executes a specific command based upon the
  2529.       menu item selected.  Let's look at the following section of the
  2530.       script.
  2531.  
  2532.            IfGoto │if Menu Item Sel is Greater to/than 1 then goto Try2
  2533.            Keys   │Added Dimension Software
  2534.            Goto   │END
  2535.            Label  │Try 2
  2536.  
  2537.       Notice that the IfGoto statement is testing to see if the menu item
  2538.       selected was anything other than the first item (greater than 1).
  2539.       If that's true, then we skip down to the section of the script that
  2540.       has the label "Try 2" (the third statement from the IfGoto in this
  2541.       case).  If the menu item selected is the first item, we do not goto
  2542.  
  2543.  
  2544.                                        39
  2545.  
  2546.       label "Try 2", instead we proceed on to the following command which
  2547.       happens to be the Keys command.  After the Keys command executes,
  2548.       we have accomplished our mission so we use the Goto command to jump
  2549.       to the very end of the script.
  2550.  
  2551.       The remainder of the script follows this same sequence of commands.
  2552.  
  2553.       NOTE: To enter the <Enter> key in the Keys command on line 11, you
  2554.       must first press <Shift><Ins> to go into "accept all keys mode",
  2555.       then hit the <Enter> key, and finally, press <Shift><Ins> keys
  2556.       again to go back to normal editing mode.
  2557.  
  2558.       Notice that the fifth and sixth menu items use the RunTask
  2559.       ("Add|GoHome Control|Run Task") and ChainTo ("Add|Misc|ChainTo")
  2560.       commands, respectively.  The RunTask command will run a task that
  2561.       has been entered into GoSched's Task List.  The ChainTo command
  2562.       will "chain to" (or start using) another script file.  Both of
  2563.       these commands do not return.  This means that the GoTo statements
  2564.       immediately following them will never execute and could therefore
  2565.       be removed.
  2566.  
  2567.       You can easily create your own menu scripts by first copying this
  2568.       script to another file and use it as a template and modify it as
  2569.       needed.
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.                                        40
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.                                    Chapter 6
  2611.  
  2612.                           Using the File Editor - GoEd
  2613.  
  2614.  
  2615.  
  2616.  
  2617.       GoHome includes a file editor that has several unique features that
  2618.       make it different from other editors.  GoEd was designed to be
  2619.       small in size, load files as quick as possible, be able to define
  2620.       the number of rows and columns to display, allow text to be
  2621.       assigned different colors, and to be integrated in with GoHome to
  2622.       behave as a "pop-up" notepad.
  2623.  
  2624.       GoEd functions like most text editors: it performs basic file
  2625.       editing, search-and-replace, and goto line operations.  It also
  2626.       provides several advanced features such as cut, copy, and paste
  2627.       blocks of text, set tabs, set maximum line length, set read-only
  2628.       mode, display control characters, and allows text to be assigned to
  2629.       macro keys.  In addition, GoEd also provides for characters to be
  2630.       displayed in different colors and the width and height of the
  2631.       editor to be set.
  2632.  
  2633.  
  2634.       6.1 Starting GoEd
  2635.  
  2636.       To give you a quick idea of what GoEd can do, let's have it display
  2637.       the file, "ASCII.TXT" (this file is included with GoHome and should
  2638.       be in the same directory).  If your are not already in the
  2639.       directory that GoHome is in, go there now.  Type the following at
  2640.       the command prompt
  2641.  
  2642.            C:> GOED ASCII.TXT
  2643.  
  2644.       You should see a window appear on your screen that covers just a
  2645.       portion of the screen.  The text in the window displays all the
  2646.       ASCII characters and their ASCII numbers.  Use the arrow and page
  2647.       keys to scroll around.  Note that some of the text is in different
  2648.       colors and that the file is in "read-only" mode so it cannot be
  2649.       edited.
  2650.  
  2651.       Before we get into how you can create files similar to this (you
  2652.       can, of course, just create/edit normal text files), let's go a
  2653.       step further.  Bring up GoSched.  Select a task that has not been
  2654.       assigned anything (task number three will work if you have been
  2655.       following along) and do the following:
  2656.  
  2657.       1.  In the "Description" field type "Display ASCII Chart"
  2658.  
  2659.  
  2660.  
  2661.  
  2662.                                        41
  2663.  
  2664.       2.  In the "Task Type" field select "Command Line"
  2665.  
  2666.       3.  In the "Command" field type "@goed /savscrn=y
  2667.           c:\gohome\ascii.txt"
  2668.  
  2669.           The '@' character at the start of the command string tells DOS
  2670.           to run the command silently (i.e.  don't write the command to
  2671.           the screen).  The /savscrn=y GoEd parameter tells GoEd to save
  2672.           the image of the screen under its window and to restore it when
  2673.           quiting.
  2674.  
  2675.           If GoEd is not in your PATH statement, specify the complete
  2676.           path for it in the Command field.  Also, it's important to
  2677.           enter the complete path for the "ASCII.TXT" file so GoEd can
  2678.           find it.
  2679.  
  2680.       4.  Bring up the Options dialog (press <Alt><O>).  Hit the down
  2681.           arrow key once to move to the "None" option in the Video Save
  2682.           section, and select it by pressing the space bar.  Next, change
  2683.           both the Memory Required and Memory Desired fields to 192.
  2684.           Then, press <Alt><C> to move to the "No countdown" field and
  2685.           press space bar to place a check mark there.
  2686.  
  2687.       5.  Save the changes to the task data file and exit GoSched.
  2688.  
  2689.       6.  Now, run another program (i.e.  your text editor).  Since we've
  2690.           added a command that will display ASCII.TXT to GoSched, we can
  2691.           execute the task whenever we want to view all the ASCII
  2692.           characters.  To do so, bring up GoHome's main menu, press <R>
  2693.           to "Run A Task", enter the number of the task you just entered
  2694.           (i.e.  3).  GoEd will then "pop-up" and display a list of ASCII
  2695.           characters!
  2696.  
  2697.       You can create similar text files (such as a To-Do list, a meetings
  2698.       list, and a Notes list) and have them available with the touch of a
  2699.       few keys!
  2700.  
  2701.       You may be wondering how GoEd knew to resize it's window and enter
  2702.       read-only mode.  If you happened to look at the very first line of
  2703.       ASCII.TXT, you would have seen the following line:
  2704.  
  2705.            GoEdCmds: /POS=2,27,23,20  /READ /GOTO=2
  2706.  
  2707.       If the first line of a file contains "GoEdCmds:", GoEd will use the
  2708.       parameters following it as the default edit parameters for the
  2709.       file.  GoEd also has a command line parameter, "/IGCMDS", that
  2710.       tells it to ignore any commands in the first line of the file.
  2711.  
  2712.       In this example, the /POS=2,27,23,20 command moves the edit window
  2713.       to the 2nd row and the 27th column of the screen.  It also sets the
  2714.       width of the editor to 23 characters and the height to 20 rows.
  2715.       Screen coordinates start with one and go to the maximum allowed by
  2716.       the screen (usually 25 rows and 80 columns).
  2717.  
  2718.  
  2719.  
  2720.  
  2721.                                        42
  2722.  
  2723.       The /READ command puts GoEd into read-only mode (i.e.  the file
  2724.       cannot be edited).  To turn off read-only mode from inside GoEd,
  2725.       press "<Alt><O>" to pop-up the Options dialog.  Then press
  2726.       "<Alt><R>" to move to the "Read only" field and remove the check
  2727.       mark by pressing the space bar.  The file can now be edited.
  2728.  
  2729.       Finally, the /GOTO=2 command tells GoEd to move to the second line
  2730.       of the file.  This will hide the commands in the first line of the
  2731.       file.
  2732.  
  2733.       While we're at it, let's see how GoEd determines when to change the
  2734.       color of the text.  Bring the Options dialog box up again and
  2735.       un-check the "Use colors codes" field (if you haven't already,
  2736.       un-check the "Read only" field also).  The text will now be
  2737.       displayed using the normal text colors and you will see something
  2738.       that looks like:
  2739.  
  2740.            GoEdCmds: /POS=2,27,23,20  /READ /GOTO=2
  2741.            0            │  128  `5╟`3
  2742.            1     `5`3  │  129  `5ⁿ3
  2743.            2     `5`3  │  130  `5Θ`3
  2744.            3     `5`3  │  131  `5Γ`3
  2745.            4     `5`3  │  132  `5Σ`3
  2746.                         .
  2747.                         .
  2748.                         .
  2749.  
  2750.       GoEd uses the forward quote (`) to tell it to use the color that
  2751.       corresponds with the number following it.  Note that there are two
  2752.       single quotes on the keyboard, the forward quote is the one that is
  2753.       typically just to the left of the number 1 key and when the <Shift>
  2754.       key is pressed will display a tilde (~) character.
  2755.  
  2756.       In this example, the character that corresponds to the ASCII number
  2757.       is changed to WHITE on BLUE and then back to CYAN on BLUE (assuming
  2758.       the default color set is used).  To do this, `5 is used to change
  2759.       the text color to WHITE on BLUE, the ASCII character follows, and
  2760.       then `3 is used to switch back to CYAN on BLUE.  To see the
  2761.       allowable colors and the number (0 to 9) used to get it, press
  2762.       "<Alt><Z>".  This will pop-up the Color Palette window.
  2763.  
  2764.  
  2765.       6.2 Getting Help
  2766.  
  2767.       Use the <F1> key to get help on the keys used.  A window will
  2768.       display listing all the keys and the operations they perform.  To
  2769.       get additional help, press <Alt><H>.  This will invoke the help
  2770.       facility so you can browse through the various topics.
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.                                        43
  2781.  
  2782.       6.3 Changing Colors
  2783.  
  2784.       Most people are finicky when it comes to the colors they use for
  2785.       their editors.  GoEd provides a couple of ways to change the colors
  2786.       used.  The simplest way is to use the /CSET and/or /PAL command
  2787.       line parameters (see 9 for details).  Another way is to specify the
  2788.       colors directly on command line with the following two parameters:
  2789.  
  2790.            "/TEXT=x"   to change the foreground and background colors
  2791.                        of the text
  2792.            "/STATUS=x" to change the foreground and background
  2793.                        colors of the top and bottom status lines
  2794.  
  2795.       "x" is replaced with a two character sequence.  The first character
  2796.       is used to select the background color and the second selects the
  2797.       foreground color.  The following table lists the available colors.
  2798.  
  2799.  
  2800.                            Character  Color
  2801.                            -------------------------
  2802.                            0          Black
  2803.                            1          Blue
  2804.                            2          Green
  2805.                            3          Cyan
  2806.                            4          Red
  2807.                            5          Magenta
  2808.                            6          Brown
  2809.                            7          White
  2810.                            8          Gray
  2811.                            9          Bright Blue
  2812.                            A          Bright Green
  2813.                            B          Bright Cyan
  2814.                            C          Bright Red
  2815.                            D          Bright Magenta
  2816.                            E          Yellow
  2817.                            F          Bright White
  2818.  
  2819.       As an example, to set the text color to Yellow on Brown and the
  2820.       status line to Yellow on Red, the following parameters would be
  2821.       added to the command line (or GOED.CFG)
  2822.  
  2823.            GOED /TEXT=6E /STATUS=4E FILE.TXT
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.                                        44
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.                                    Chapter 7
  2847.  
  2848.                           Appendix A - Business Stuff
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.       7.1 The Shareware Concept
  2855.  
  2856.       Shareware distribution gives users a chance to try software before
  2857.       buying it.  If you try a Shareware program and continue using it,
  2858.       you are expected to register.  Individual programs differ on
  2859.       details some request registration while others require it, some
  2860.       specify a maximum trial period.  With registration, you get
  2861.       anything from the simple right to continue using the software to an
  2862.       updated program with printed manual.  See "Registering GoHome"
  2863.       below for details on what you will receive in return for
  2864.       registering this program.
  2865.  
  2866.       Copyright laws apply to both Shareware and commercial software, and
  2867.       the copyright holder retains all rights, with a few specific
  2868.       exceptions as stated below.  Shareware authors are accomplished
  2869.       programmers, just like commercial authors, and the programs are of
  2870.       comparable quality.  (In both cases, there are good programs and
  2871.       bad ones!) The main difference is in the method of distribution.
  2872.       The author specifically grants the right to copy and distribute the
  2873.       software, either to all and sundry or to a specific group.  For
  2874.       example, some authors require written permission before a
  2875.       commercial disk vendor may copy their Shareware.  See the files
  2876.       VENDOR.DOC distribution rights for GoHome and its utilities.
  2877.  
  2878.       Shareware is a distribution method, not a type of software.  You
  2879.       should find software that suits your needs and pocketbook, whether
  2880.       it's commercial or Shareware.  The Shareware system makes fitting
  2881.       your needs easier, because you can try before you buy.  Because the
  2882.       overhead is low, prices are low also.  Shareware has the ultimate
  2883.       money-back guarantee if you don't use the product, you don't pay
  2884.       for it.
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.                                        45
  2899.  
  2900.       7.2 Benefits of Registering
  2901.  
  2902.       Participating in the shareware marketplace as a registered user
  2903.       brings more than the mere satisfaction of doing the right thing,
  2904.       you really become a part of the creative process.  We at Added
  2905.       Dimension Software welcome any comments, requests or suggestions
  2906.       you may have for enhancements to this program, or for entirely new
  2907.       programs you would like to see produced and distributed as
  2908.       shareware.  Please let us know how we may serve you in any way we
  2909.       can.
  2910.  
  2911.       Registered users will receive:
  2912.  
  2913.         . The latest version of the GoHome programs (GoHome.exe,
  2914.           GoSched.exe, GoEd.exe, GoScript.exe, and GoHelp.exe) devoid of
  2915.           ALL Shareware notices and reminder screens.
  2916.  
  2917.         . Bound printed versions of the Tutorial and a Reference Manual.
  2918.  
  2919.         . Technical support for the first three months.
  2920.  
  2921.         . A software license which will allow you to LEGALLY use GoHome.
  2922.           Non-registered users are only licensed to use it for a 30 day
  2923.           evaluation period.  If you continue to use GoHome after the 30
  2924.           day trial period you MUST register.
  2925.  
  2926.         . Be allowed to upgrade at substantial savings.
  2927.  
  2928.         . Kept abreast of updates and new product offerings from Added
  2929.           Dimension Software.  We would also love to hear about how you
  2930.           are using GoHome and any "tips and techniques" that you've
  2931.           found useful.
  2932.  
  2933.  
  2934.       7.3 Registering GoHome
  2935.  
  2936.       If you find GoHome to be a useful tool, please register it.  Added
  2937.       Dimension Software depends on your support in order to continue to
  2938.       serve your needs with high quality, reasonably priced software.
  2939.  
  2940.       To register, send $50 (postage FREE) cash, check, or money order to
  2941.       Added Dimension Software at the address below.  Texas residents
  2942.       please add the current sales tax to the total.
  2943.  
  2944.       Outside the USA and Canada, please add $6 to cover special shipping
  2945.       and handling costs, for a total of $56.  US funds drawn on a US
  2946.       bank, or cash are acceptable cash payments and should be sent via
  2947.       registered mail and may be in US funds or in your country's
  2948.       currency at the current exchange rate.  Added Dimension Software
  2949.       cannot be responsible for cash payment lost in the mail.
  2950.  
  2951.       An order form is enclosed in the file REGFORM.TXT on the
  2952.       distribution disk and may printed and mailed in.
  2953.  
  2954.  
  2955.  
  2956.  
  2957.                                        46
  2958.  
  2959.       Credit Card orders will be accepted through Public (software)
  2960.       Library (PsL).  Call the PsL toll-free order line (800)242-4775 to
  2961.       place your order.  To speed your order use PsL's item number #11304
  2962.       for GoHome when ordering.  This 800 number is for ORDERS ONLY!  The
  2963.       people there are unable to answer any other questions about the
  2964.       program.  For information on the program or technical help please
  2965.       call Added Dimension Software direct at the number below.
  2966.  
  2967.       You may also instantly register via CompuServe's Shareware
  2968.       Registration service.  The registration fee will be billed to your
  2969.       CompuServe account, and the registered version will be shipped to
  2970.       you immediately!  Just log onto CompuServe and type "GO SWREG" at
  2971.       the !  prompt.  Then choose "Register Shareware" and search the
  2972.       database using the Registration ID: 2482, or Program Name:
  2973.       "GoHome".  Then just follow the on screen instructions.
  2974.  
  2975.       For further information please feel free to contact Added Dimension
  2976.       Software via mail, phone, or email at:
  2977.  
  2978.                          Added Dimension Software, Inc.
  2979.                                 6780 Abrams Rd.
  2980.                                  Suite 103-190
  2981.                                 Dallas, TX 75231
  2982.  
  2983.                          Phone (voice): (214) 341-5759
  2984.                            CompuServe ID: 73311,1062
  2985.  
  2986.  
  2987.       7.4 ASP Ombudsman statement
  2988.  
  2989.       Added Dimension Software is a member of the Association of
  2990.       Shareware Professionals (ASP).  ASP wants to make sure that the
  2991.       shareware principle works for you.  If you are unable to resolve a
  2992.       shareware-related problem with an ASP member by contacting the
  2993.       member directly, ASP may be able to help.  The ASP Ombudsman can
  2994.       help you resolve a dispute or problem with an ASP member, but does
  2995.       not provide technical support for members' products.  Please write
  2996.       to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427
  2997.       USA, FAX 616-788- 2765, or send a CompuServe message via CompuServe
  2998.       Mail to ASP Ombudsman 70007,3536.
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.                                        47
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.                                    Chapter 8
  3024.  
  3025.                      Appendix B - Using Configuration Files
  3026.  
  3027.  
  3028.  
  3029.  
  3030.       It can be quite tedious if you have to enter a number of command
  3031.       line parameters each time a program is run.  Further, you cannot
  3032.       specify any command line parameters when GoHome is used to invoke
  3033.       GoSched or when GoSched is used to edit batch files (start GoEd)
  3034.       and script files (start GoScript) by pressing the <F6> key.  To get
  3035.       around these limitations, each program looks for a configuration
  3036.       file when starting.  If a configuration file is found, each
  3037.       parameter it contains is acted on as if it was entered on the
  3038.       command line.  Options specified in a configuration file will be
  3039.       overridden by those specified on the command line.
  3040.  
  3041.       The default name for the configuration files is the name of the
  3042.       executable with a file extension of ".cfg" as shown below:
  3043.  
  3044.  
  3045.                          Program   Configuration file
  3046.                          -----------------------------
  3047.                          GoHome    GOHOME.CFG
  3048.                          GoSched   GOSCHED.CFG
  3049.                          GoScript  GOSCRIPT.CFG
  3050.                          GoEd      GOED.CFG
  3051.                          GoHelp    GOHELP.CFG
  3052.  
  3053.       You may set up a number of configuration files and specify the one
  3054.       you want to use on the command line by appending an "@" symbol
  3055.       before the configuration file name.  For example, to use
  3056.       JOHNS_ED.CFG file when starting GoEd you would enter:
  3057.  
  3058.            C:> GOED @JOHNS_ED.CFG FILE.TXT
  3059.  
  3060.       where JOHNS_ED.CFG might contain the following three lines
  3061.  
  3062.            /TEXT=6B /STATUS=2E
  3063.            /TAB=8
  3064.            /LEN=255
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.                                        48
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.                                    Chapter 9
  3083.  
  3084.                        Appendix C - Using /CSET and /PAL
  3085.  
  3086.  
  3087.  
  3088.  
  3089.       Most of the GoHome programs allow you to specify a number of
  3090.       different color schemes and color palettes.
  3091.  
  3092.       There are six different color schemes that are specified using the
  3093.       /CSET=n parameter on the command line or in the configuration file.
  3094.  
  3095.       The "n" value may be one of the following:
  3096.  
  3097.            n    Color Set
  3098.            ----------------------
  3099.            b    black and white
  3100.            m    monochrome
  3101.            1    normal color set
  3102.            2    second color set
  3103.            3    third color set
  3104.            4    fourth color set
  3105.  
  3106.       To specify a color palette, use the /PAL=n parameter where "n" is
  3107.       one of:
  3108.  
  3109.            n   Palette Set
  3110.            --------------------------------------
  3111.            0   Use the "normal" PC color palette
  3112.            1   Use the first color palette
  3113.            2   Use the second color palette
  3114.  
  3115.       Palette sets are only available on color monitors.  Different color
  3116.       and palette sets will result in different color combinations.
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.                                        49
  3135.